Xamarin.Formsアプリケーションにファイルをアップロードします。 パート1

アプリケーション間でファイルを転送することは、OSの特定の機能です。 そして、これはXamarin.Formsでやろうとしないのが最善です。 実際には非常に簡単です。この投稿では、この機能を取得してiOSで実行する方法を示します（次の投稿では、Androidの場合と、必要に応じてUWPについて説明します）。



これは、モバイルアプリケーションを使用する一般的な方法です。あるアプリケーションでファイルを開き、このファイルをさらに処理するために別のアプリケーションを使用する必要があります。 たとえば、PDFファイルを開き、別のアプリケーションでこのファイルに変更を加える必要があります。 このPDFファイルをタップすると、画面に「開く」メニューが表示され、このファイルを好みのアプリケーションにインポートできます。

この投稿では、ソリューションのFormsフラグメントへのiOS用アプリケーションの拡張機能の作成については説明しません。そのため、ユーザーが[共有]ボタン（そこから出る矢印の付いた小さな長方形）をタップするとアプリケーションが表示されます。 この場合、アプリケーション間でのコンテンツの交換ではなく、ファイルをFormsアプリケーションに転送することを検討します。

スクリプト

この投稿の例は、PDFファイルを開いてWebViewに表示できるように登録されたXamarin.Formsアプリケーションです。 ここでは、iOS、したがってXamarin.Forms（これはAndroidにも適用されます）の登録の基本について説明します。

iOS登録

Formsアプリケーションが登録されると言うとき、それはこれらのスクリーンショットのように機能することを意味します。 Safariでは、PDFファイルのあるページが開きます。

アプリケーションは「OpenForms」と呼ばれ、最初のスクリーンショットでは、iOSはクイックコマンド「Open In OpenForms」を使用してファイルを直接開く機能を提供します。

2番目のスクリーンショットでは、「詳細」メニューをタップすると、ウィンドウが表示され、下部にアクションのリストが表示されます。 ここには、目的のアプリケーションのショートカットが表示されます。

Info.plist

iOSでこのアプリケーションがPDFファイルを処理できることを理解するには、Info.plistファイルを調整する必要があります。 新しいトップレベルキーを追加する必要があります。 これを行うには、Xamarin Studioの組み込みエディターを使用するか、直接編集します。

Xamarin Studioを使用するには、Info.Plistをダブルクリックして、組み込みエディターを開きます。 画面下部の「詳細」タブを選択します。 最上部の[ドキュメントタイプ]セクションで、[ドキュメントタイプの追加]ボタンをクリックします。 これにより、以下のスクリーンショットのようにセクションが追加されます。



これはあなたがそれを埋めるために必要な方法です。

名前 ：任意の名前。 後で参照するために必要になります。
タイプ ：これは特定の文字列の配列になります。 詳細については、以下をご覧ください。
アイコン ：メインアプリケーションのショートカットではなく、[その他]メニューに表示されるショートカットの場所。 繰り返しますが、複数のショートカットがある場合、これは文字列の配列になります。

この方法で入力すると、Info.plistが変更され、アプリケーションを登録して他の種類のファイルを開くことができます。 しかし、ここでは、Info.plistの変更点を理解するために、より詳細に理解する価値があります。 このファイルに追加のキーを追加できることがわかりますが、これはIDEで常に実行できるとは限りません。

目的のタイプのファイルのオープンを登録するために使用された辞書全体を以下に示します。

<key>CFBundleDocumentTypes</key> <array> <dict> <key>CFBundleTypeName</key> <string>PDF</string> <key>CFBundleTypeRole</key> <string>Viewer</string> <key>LSHandlerRank</key> <string>Alternate</string> <key>LSItemContentTypes</key> <array> <string>com.adobe.pdf</string> </array> </dict> </array> 

CFBundleDocumentTypes最上位のディクショナリのキー。これには他のディクショナリオブジェクトの配列が含まれます。

• CFBundleTypeName 。 このキーには、タイプを参照するドキュメントタイプの名前が含まれています。
• CFBundleTypeRole 。 このキーにより、OSはこのタイプのファイルを処理するアプリケーションを決定できます。 特定の場合、これはビューアです。
• LSHandlerRank ファイルタイプに対するアプリケーションの重要度レベルを定義します。 Microsoft Wordは、Wordファイルのデフォルトです。 アプリケーションは「代替」に設定されています。
• LSItemContentTypes 。 文字列の配列。 これは、アプリケーションが開くことができるファイルの種類を定義します。

LSItemContentTypesを除き、すべてが非常に単純LSItemContentTypes 。 これらの値はどこで入手できますか？ この目的のために、Uniform Type Identifierがあります。 これは、ファイルタイプを識別する文字列です。 公的に登録された文字列のリストは、 この Appleドキュメントページにあります 。

ここで、iOSが、開くのを待っているファイルがあることをアプリケーションに知らせる方法を理解する必要があります。

オープンiOSイベントへの応答

誰かがこのアプリケーションを選択してPDFファイルを開くと、次の関数が呼び出されます。

 public override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options) 

iOSは、このアプリケーションによって開かれるファイルを、アプリケーションがアクセスし、 NSUrl urlパラメーターを使用して指定されたリポジトリにNSUrl urlます。 次に、このファイルをXamarin.Formsで処理する必要があります。

AppDelegateは次のようになります。

 App mainForms; public override bool FinishedLaunching(UIApplication app, NSDictionary options) { global::Xamarin.Forms.Forms.Init(); mainForms = new App(); LoadApplication(mainForms); return base.FinishedLaunching(app, options); } public override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options) { mainForms.DisplayThePDF(url.Path); return true; } 

いくつかの異常な瞬間があります。 最初に、 mainFormsのAppクラスのローカル変数Xamarin.Forms mainFormsが保存されます。 後でPDFを表示するためのエントリポイントとして必要になります。

また、 OpenUrl関数では、 OpenUrl変数のDisplayPDF()関数がmainForms 。 これにより、PDFがXamarin.Formsに表示されます。 理想的には、場所をクリアするには、PDFをコピーし、urlパラメーターで指定されたソースを削除する必要があります。 しかし、この場合はそうではありません。

Xamarin.Forms！

私はiOSからのカスタマイズについて多くの時間を費やしました。 ただし、実際のプロジェクトで作業を開始する場合、iOSの一部は形式にすぎません。 実際の作業は、Xamarin.Formsから始まります。受信ファイルを処理する方法です。 これを行うために、Xamarin Webサイトで見つけた記事のPDF表示にコメントを残しました 。 これは、レンダラーのセットアップに関するものです。

次に、フォームソリューションへのエントリポイントに焦点を当てたいと思います。

App.xaml.csファイルまたはAppクラス（AppDelegateがアクセスできるクラス）には、iOSプロジェクトとFormsプロジェクト間の相互作用を定義する関数があります。

 public void DisplayThePDF(string url) { var openFilePage = new OpenFilesPage(url);; _navigationRoot.Navigation.PushModalAsync(new NavigationPage(openFilePage)); } 

この関数は、新しいXamarin.Formsページを作成し、そこにファイルの場所を転送し、ページをモーダルに表示します（ Appクラスのコンストラクターでは、すべてがNavigationPageネストされ、 _navigationRoot変数に格納されます）。

モーダルで表示されるので、アプリケーションで発生する他のすべての上に表示され、ナビゲーションスタックに影響を与えません（上に表示されるものを除く）。 もちろん、オリエンテーションはPDFファイルを表示することです。 実際のアプリケーションでは、アプリケーション自体の状態を確認する必要があります-現在表示されているもの（モーダルウィンドウのスタックがないように）。 アプリケーションワークフローでは、スタック全体を閉じて最初からやり直すか、タブを使用している場合は新しいタブに切り替える必要があります。

OpenFilesPageは、各プラットフォーム用のカスタムレンダラーを備えたWebViewサブクラスがあります。 このクラスには、表示するファイルの場所のプロパティがあります。 次に、カスタムレンダラーがそれを表示します。
カスタムレンダラーでファイルを表示すると、iOSの特定のファイルの場所への切り替えを回避できます。 しかし、これもこの特定のシナリオでのみです。 重要なポイントは、iOSプロジェクトにアクセスするためのエントリポイントでのAppクラスの必要性です。

まとめ

一般に、Xamarin.Formsアプリケーションの一部のアプリケーションからファイルを開くことはそれほど難しくありません。 いくつかの形式があり、その1つは、Info.plistファイルを調整して、特定のタイプのファイルを処理できるアプリケーションとして登録することです。 また、iOSアプリケーションのOpenUrl関数を書き換える必要があります。

その後は、すべてXamarin.Formsに依存します。 iOS AppDelegateがコードの「共通」部分にアクセスできるように、 Appクラスにエントリポイントを作成する必要があります。 ここでは、ファイルの処理内容に応じて行動する必要があります。 表示するには、カスタムレンダラーを作成する必要がある場合があります。 または、追加のプラットフォーム機能が必要ない場合は、共通のプロジェクトですべてを実行できます。

翻訳していただきありがとうございます。

アレクサンダー・アレクシーエフ-Xamarin-developer、フリーランサー。 2012年から.NETプラットフォームを使用しています。 彼はディガンマの調達自動化システムの開発に参加しました。 2015年以来、彼はフリーランスに入り、Xamarinを使用したモバイル開発に切り替えました。 現在、iOSアプリケーションでStecPointで作業しています。

リソースXamDev.ruおよびソーシャルネットワークのコミュニティ「Xamarin Developers」をリードしています： VK 、 Facebook 、 Telegram 。