Archived

This repository has been archived on 2023-11-19. You can view files and clone it, but cannot push or open issues or pull requests.

Morgan McMillian 892cb0e141 add native android build sources

2018-07-15 19:24:48 -07:00

7.1 KiB

Raw Blame History

プラグイン開発者のためのメモ

これらのノートは主に Android と iOS 開発者インタフェースファイルのプラグインを使用してファイルシステムでプラグインを書きたい人向け。

コルドバのファイルシステムの Url での作業

バージョン 1.0.0 では、以来、このプラグインを含む Url を使用する cdvfile JavaScript に raw デバイスファイルシステムのパスを公開するのではなく、橋の上のすべての通信方式します。

JavaScript 側では、これはファイルと DirectoryEntry オブジェクトに HTML ファイルシステムのルートを基準として、fullPath 属性があることを意味します。あなたのプラグインの JavaScript API がファイルまたは DirectoryEntry オブジェクトを受け入れる場合を呼び出す必要があります .toURL() 橋を渡ってそれをネイティブコードに渡す前にそのオブジェクトの。

Cdvfile に変換する://fileystem のパスに Url

ファイルシステムへの書き込みする必要があるプラグインは、実際のファイルシステムの場所に受信したファイルシステム URL に変換する必要があります。ネイティブプラットフォームによって、これを行うための複数の方法があります。

それを覚えていることが重要ですすべて cdvfile:// の Url がデバイス上の実際のファイルをマッピング可能な。いくつかの Url は、ファイルでは表されないまたはリモートリソースを参照することができますもデバイス上の資産を参照できます。これらの可能性のためのプラグインは、戻るときにパスに Url を変換しようとして、彼らは意味のある結果を得るかどうか常にテスト必要があります。

アンドロイド

アンドロイド, に変換する最も簡単な方法で、 cdvfile:// を使用するファイルシステムのパスに URL は org.apache.cordova.CordovaResourceApi 。 CordovaResourceApi扱うことができるいくつかの方法は、 cdvfile:// の Url:

webView プラグイン クラス CordovaResourceApi resourceApi のメンバーである = webView.getResourceApi()。

デバイスでこのファイルを表す file:///URL を取得//ファイル Uri fileURL にマップできない場合、同じ URL は変更されません = resourceApi.remapUri(Uri.parse(cdvfileURL));

また、ファイルのプラグインを直接使用することが可能です。

インポート org.apache.cordova.file.FileUtils;
インポート org.apache.cordova.file.FileSystem;
インポート java.net.MalformedURLException;

プラグイン マネージャーからファイルのプラグインを入手してコマンド filePlugin = (FileUtils)webView.pluginManager.getPlugin("File");

それを試みるためにパスを取得 URL を指定すると、{文字列パス = filePlugin.filesystemPathForURL(cdvfileURL);} キャッチ (MalformedURLException e) {/ファイルシステムの url が認識されませんでした/}

パスから変換する、 cdvfile:// URL:

インポート org.apache.cordova.file.LocalFilesystemURL;

デバイス ・ パスの LocalFilesystemURL オブジェクトを取得//cdvfile URL として表現できない場合は null。
LocalFilesystemURL url = filePlugin.filesystemURLforLocalPath(path);
URL オブジェクトの文字列 cdvfileURL の文字列表現を取得する = url.toString();

あなたのプラグインは、ファイルを作成しをファイルオブジェクトを返す場合、ファイルのプラグインを使用します。

JavaScript を返すときに適した JSON 構造を返す//このファイルは cdvfile URL として表現できない場合は null。
JSONObject エントリ = filePlugin.getEntryForFile(file);

iOS

IOS のコルドバは同じを使用しない CordovaResourceApi アンドロイドとしての概念。IOS では、Url とファイルシステムのパスの間を変換するファイルプラグインを使用する必要があります。

URL の文字列 CDVFilesystemURL * url から CDVFilesystem URL オブジェクトを取得 [CDVFilesystemURL fileSystemURLWithString:cdvfileURL];
ファイル NSString * パスにマップできない場合は nil または URL オブジェクトのパスを取得 [filePlugin filesystemPathForURL:url];


デバイス ・ パスの CDVFilesystem の URL オブジェクトを取得または//cdvfile URL として表現できない場合は nil です。
CDVFilesystemURL の url = [filePlugin fileSystemURLforLocalPath:path];
URL オブジェクト NSString * cdvfileURL の文字列表現を取得する = [url absoluteString];

あなたのプラグインは、ファイルを作成しをファイルオブジェクトを返す場合、ファイルのプラグインを使用します。

デバイス ・ パスの CDVFilesystem の URL オブジェクトを取得または//cdvfile URL として表現できない場合は nil です。
CDVFilesystemURL の url = [filePlugin fileSystemURLforLocalPath:path];
JavaScript NSDictionary * エントリに戻る構造を得る = [filePlugin makeEntryForLocalURL:url]

Java スクリプトの設定

Java スクリプトの設定を取得するに、 cdvfile:// ファイルまたは DirectoryEntry オブジェクトからの URL を呼び出して、 .toURL() それを。

var cdvfileURL = entry.toURL();

プラグイン応答ハンドラーに返された FileEntry 構造体の実際のエントリオブジェクトを変換する、ハンドラーのコードファイルのプラグインをインポート、新しいオブジェクトを作成します。

適切なエントリ オブジェクト var エントリを作成します。
場合 (entryStruct.isDirectory) {エントリ = 新しい DirectoryEntry (entryStruct.name、entryStruct.fullPath、新しい FileSystem(entryStruct.filesystemName));} 他 {エントリ = 新しいファイル (entryStruct.name、entryStruct.fullPath、新しい FileSystem(entryStruct.filesystemName));}

7.1 KiB Raw Blame History