コメント
コメントの投稿
※名前とタイトルが入力されていないコメントでは他のコメントとの区別ができません。
入力されていないコメントには返信しませんのであらかじめご了承くださいませ。
バインドライブラリの作成方法 -Android編- | Xamarin.Forms
- 2017/08/24
- 15:03
今回はXamarin.Androidでバインドライブラリを作成する方法をご紹介いたします。
バインドライブラリとは、Javaで作成された実行ファイル「jarファイル」やAndroid用に作成された実行ファイル「aarファイル」等、ネイティブなファイルをXamarinに取り込み、Xamarin上で動作するように変換できるライブラリです。
すなわち、ネイティブなjavaからXamarinのC#への変換ができる強力なツールとなります。
しかも、基本的にはjar/aarファイルを取り込み、少しだけ設定を行い、ビルドするだけの簡単手順で動作可能です。
尚、iOSでのバインドライブラリの作成方法は次回の記事「バインドライブラリの作成方法 -iOS編-」にてご紹介しております。
前提条件
・Windows10 Pro 64Bit
・Visual Studio 2015 Community Update3
・Xamarin 4.3.0.795 (NuGet Xamarin.Forms 2.3.4.247)
１．バインドライブラリ
（１）Visual Studioでバインドライブラリプロジェクトを作成します。ネイティブなjarファイル/aarファイルはバインドライブラリのプロジェクトを使用すると簡単にJavaからC#に変換できます。
（２）ソリューションエクスプローラを開き、バインドライブラリ内のJarsフォルダに変換したいjar/aarファイルをドラッグ＆ドロップします。
ファイル名称に文字の制限等はありません。数字・記号等含んでいても大丈夫です。
２．ビルドアクション
ビルドアクションをjarファイルの場合は 「EmbeddedJar」に変更します。
aarファイルの場合は「LibraryProjectZip」に変更します。
※jarファイルの場合は「InputJar」でも動作可能ですが、jarファイルも出力しないといけません。設定するケースはレアでしょう。
３．NuGetパッケージ
aarファイルをバインドする場合、aarファイルから参照されているNuGetパッケージをインストールします。aarファイルにより必要なパッケージが異なりますので、aarファイルを作成されたベンダーにご確認ください。４．Metadata.xml
通常は必要ありませんが、Metadata.xmlに追加が必要な場合があります。ビルド時にjavaからC#に変換する際に競合する変数を識別するための設定です。
これが無いとビルドしてもSDKの全てのクラスライブラリを使用することができません。
以下のようにxmlに設定を追加します。
例：バインドライブラリプロジェクト\Transforms\Metadata.xml
<metadata>
<attr path="/api/package[@name='net.nend.android']/
interface[@name='NendAdNativeListListener']/method[@name='onDisplayAd']"
name="argsType">NativeListListenerDisplayAdEventArgs</attr>
<attr path="/api/package[@name='net.nend.android']/
interface[@name='NendAdNativeListListener']/method[@name='onReceiveAd']"
name="argsType">NativeListListenerReceiveAdEventArgs</attr>
<attr path="/api/package[@name='net.nend.android']/
interface[@name='NendAdNativeListener']/method[@name='onClick']"
name="argsType">NendAdNativeListenerClickEventArgs</attr>
</metadata>
５．アプリケーションプロパティ
必要があればAndroidプロジェクトのプロパティを変更します。バインドライブラリをビルドして得られるDLLの容量が極端に少ない場合やILSpy.exeで逆コンパイルした結果内容に必要な関数が入っていない場合など、このプロパティを変更してビルドしてみると良いかもしれません。Android Class Parser :
| 項目 | 説明 |
|---|---|
| jar2xml | jar2xml.jar Javaリフレクションを使用して.jarファイルから型およびメンバーを抽出するために使用します。 |
| class-parse | class-parse.exe JVMの助けなしに直接Javaバイトコードを解析するために使用します。この値は実験的です。 |
・デフォルト値はjar2xmlです。
Android Codegen Target :
| 項目 | 説明 |
|---|---|
| XamarinAndroid | Android 1.0用のMono以降のJNIバインディングAPIを使用します。Xamarin.Android 5.0以降で構築されたバインディングアセンブリは、Xamarin.Android 5.0以降（API / ABI追加）でのみ実行できますが、ソースは以前の製品バージョンと互換性があります。 |
| XAJavaInterop1 | JNI呼び出しにJava.Interopを使用します。使用しているアセンブリをバインドXAJavaInterop1するには、Xamarin.Android 6.1以降でのみビルドして実行できます。Xamarin.Android 6.1以降Mono.Android.dllはこの値にバインドされます。 |
・デフォルト値はXamarinAndroidです。
詳しくはXamarin公式ページをご確認ください。
６．ビルドと参照設定
（１）BindLibraryプロジェクトをビルドします。（２）AndroidプロジェクトからビルドしたBindLibraryプロジェクトまたはビルドしたDLLを参照設定します。
７．実装例
実際にバインドライブラリを用いた作成例を以下の記事でご紹介しておりますので、ご参考にしてください。「nendでバナー広告を表示する方法 -Android編-」
最後までお読みいただきありがとうございます。
当ブログの内容をまとめた Xamarin逆引きメニュー は以下のURLからご覧になれます。
https://itblog.dynaspo.com/blog-entry-81.html
- 関連記事
-
- Xamarin.iOSでNavigationの戻るボタンでエラーが発生する原因について | Xamarin.Forms
- バインドライブラリの作成方法 -iOS編-
- バインドライブラリの作成方法 -Android編- | Xamarin.Forms
- nendでバナー広告を表示する方法 -iOS編- | Xamarin.Forms
- Flurry from Yahooでアプリ広告を表示する方法 | Xamarin.Forms
