應用間使用Want分享數據

在應用使用場景中，用戶經常需要將應用內的數據（如文字、圖片等）分享至其他應用以供進一步處理。Want支持實現應用間的數據分享。

應用文件分享

應用文件分享是應用之間通過分享URI（Uniform Resource Identifier）或文件描述符FD（File Descriptor）的方式，進行文件共享的過程。

• 基于URI分享方式，應用可分享單個文件，通過[ohos.app.ability.wantConstant]的wantConstant.Flags接口以只讀或讀寫權限授權給其他應用。應用可通過[ohos.file.fs]的open接口打開URI，并進行讀寫操作。當前僅支持臨時授權，分享給其他應用的文件在被分享應用退出時權限被收回。
• 基于FD分享方式，應用可分享單個文件，通過ohos.file.fs的open接口以指定權限授權給其他應用。應用從Want中解析拿到FD后可通過ohos.file.fs的讀寫接口對文件進行讀寫。

由于FD分享的文件關閉FD后，無法再打開分享文件，因此不推薦使用，本文重點介紹基于URI[分享文件給其他應用]或[使用其他應用分享的文件]。

應用可分享目錄

文件URI規范

文件URI的格式為：

格式為file:///

• file：文件URI的標志。
• bundleName：該文件資源的屬主。
• path：文件資源在應用沙箱中的路徑。

分享文件給其他應用

在分享文件給其他應用前，開發者需要先[獲取應用文件路徑]。

1. 獲取文件在應用沙箱中的路徑，并轉換為文件URI。

   import UIAbility from '@ohos.app.ability.UIAbility';
   import fileUri from '@ohos.file.fileuri';
   import window from '@ohos.window';
   
   export default class EntryAbility extends UIAbility {
     onWindowStageCreate(windowStage: window.WindowStage) {
       // 獲取文件的沙箱路徑
       let pathInSandbox = this.context.filesDir + "/test1.txt";
       // 將沙箱路徑轉換為uri
       let uri = fileUri.getUriFromPath(pathInSandbox);
       // 獲取的uri為"file://com.example.demo/data/storage/el2/base/files/test.txt"
     }
   }
   

2. 設置獲取文件的權限以及選擇要分享的應用。 分享文件給其他應用需要使用[startAbility]接口，將獲取到的URI填充在want的參數uri中，標注URI的文件類型，type字段可參考[Want屬性]，并通過設置want的flag來設置對應的讀寫權限，action字段配置為"ohos.want.action.sendData"表示進行應用文件分享，開發示例如下。

   說明：

   寫權限分享時，同時授予讀權限。

   import fileUri from '@ohos.file.fileuri';
   import window from '@ohos.window';
   import wantConstant from '@ohos.app.ability.wantConstant';
   import UIAbility from '@ohos.app.ability.UIAbility';
   import Want from '@ohos.app.ability.Want';
   import { BusinessError } from '@ohos.base';
   
   export default class EntryAbility extends UIAbility {
     onWindowStageCreate(windowStage: window.WindowStage) {
       // 獲取文件沙箱路徑
       let filePath = this.context.filesDir + '/test1.txt';
       // 將沙箱路徑轉換為uri
       let uri = fileUri.getUriFromPath(filePath);
       let want: Want  = {
         // 配置被分享文件的讀寫權限，例如對被分享應用進行讀寫授權
         flags: wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION | wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
         // 配置分享應用的隱式拉起規則
         action: 'ohos.want.action.sendData',
         uri: uri,
         type: 'text/plain'
       }
       this.context.startAbility(want)
         .then(() = > {
           console.info('Invoke getCurrentBundleStats succeeded.');
         })
         .catch((err: BusinessError) = > {
           console.error(`Invoke startAbility failed, code is ${err.code}, message is ${err.message}`);
         });
     }
     // ...
   }
   

圖1 效果示意圖：

使用其他應用分享的文件

被分享應用需要在[module.json5配置文件]的actions標簽的值配置為"ohos.want.action.sendData"，表示接收應用分享文件，配置uris字段，表示接收URI的類型，即只接收其他應用分享該類型的URI，如下表示本應用只接收scheme為file，類型為txt的文件，示例如下。

{
  "module": {
    ...
    "abilities": [
      {
        ...
        "skills": [
          {
            ...
            "actions": [
              "ohos.want.action.sendData"
            ],
            "uris": [
              {
                "scheme": "file",
                "type": "text/plain"
              }
           ]
          }
        ]
      }
    ]
  }
}

被分享方的UIAbility被啟動后，可以在其[onCreate()]或者[onNewWant]回調中獲取傳入的Want參數信息。

通過接口want的參數獲取分享文件的URI，獲取文件URI后通過fs.open接口打開文件，獲取對應的file對象后，可對文件進行讀寫操作。

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
// xxx.ets
import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';

function getShareFile() {
  try {
    let want: Want = {}; // 此處實際使用時應該修改為獲取到的分享方傳遞過來的want信息

    // 從want信息中獲取uri字段
    let uri = want.uri;
    if (uri == null || uri == undefined) {
      console.info('uri is invalid');
      return;
    }
    try {
      // 根據需要對被分享文件的URI進行相應操作。例如讀寫的方式打開URI獲取file對象
      let file = fs.openSync(uri, fs.OpenMode.READ_WRITE);
      console.info('open file successfully!');
    } catch (err) {
      let error: BusinessError = err as BusinessError;
      console.error(`Invoke openSync failed, code is ${error.code}, message is ${error.message}`);
    }
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error(`Invoke openSync failed, code is ${err.code}, message is ${err.message}`);
  }
}

審核編輯 黃宇