コメント
コメントの投稿
※名前とタイトルが入力されていないコメントでは他のコメントとの区別ができません。
入力されていないコメントには返信しませんのであらかじめご了承くださいませ。
バインドライブラリの作成方法 -iOS編-
- 2017/08/24
- 16:31
今回はXamarin.iOSでバインドライブラリを作成する方法をご紹介いたします。
バインドライブラリとは、Objective-Cで作成されたビルド済みのファイル「aファイル」等、ネイティブなファイルをXamarinに取り込み、Xamarin上で動作するように変換できるライブラリです。
すなわち、ネイティブなObjective-CからXamarinのC#への変換ができる強力なツールとなります。
しかし、ビルドまでには少し難解な手順がありますので、順を追って見ていきたいと思います。
尚、Androidでのバインドライブラリの作成方法は前回の記事「バインドライブラリの作成方法 -Android編-」にてご紹介しております。
前提条件
・Windows10 Pro 64Bit
・Visual Studio 2015 Community Update3
・Xamarin 4.3.0.795 (NuGet Xamarin.Forms 2.3.4.247)
・macOS Sierra 10.12.4 / Xcode8.3.1 / Xamarin.iOS 10.6.0.10
１．frameworkとは
SDK等をダウンロードして、解凍するとframeworkフォルダになっている場合があります。これはXcodeで作成したObjective-Cのコードをビルドして一定のルールに基づいた階層にまとめたものになります。frameworkフォルダは以下のように構成されております。
SDK.framework -> Headers フォルダ -> *.h ファイル
-> Resources フォルダ
-> Versions フォルダ
-> 拡張子の無いSDKファイル
ここで必要となるのは、拡張子の無いSDKファイルと *.hファイル群です。
拡張子の無いSDKファイルに、拡張子「.a」を付けます。
２．バインドライブラリ
（１）Visual Studioでバインドライブラリプロジェクトを作成します。
（２）ソリューションエクスプローラを開き、バインドライブラリ内のトップディレクトリにリネームしたaファイルをドラッグ＆ドロップします。
３．Objective Sharpie
ネイティブなaファイルから、XamarinのC#に変換するために必要な変換定義ファイルを自動生成するのがObjective Sharpieです。基本的には、ダウンロードしたSDKのframeworkフォルダをMac上にコピーし、ターミナルからsharpie bind コマンドで frameworkフォルダ内のHeaderファイル群を読み込みます。
※作成する方法は以前の記事「Objective Sharpieの使用方法」をご参考ください。
自動生成により２つのファイルが作成されます。
ApiDefinitions.cs
StructsAndEnums.cs
（※SDKの種類によりStructsAndEnums.csは作成されない場合があります。）
上記２つのファイルをバインドライブラリのトップディレクトリに配置します。
よって以下のようなフォルダ構成になります。
※linkwith.csファイルは自動で作成されます。
４．ビルドアクション
３つのファイルのビルドアクションを変更します。| ファイル名 | ビルドアクション |
|---|---|
| SDK.a | ObjcBindingNativeLibrary |
| ApiDefinitions.cs | ObjcBindingApiDefinition |
| StructsAndEnums.cs | ObjcBindingCoreSource |
５．変換定義ファイルの編集
Objective Sharpieで自動生成された定義ファイルが正確ではないため、修正します。基本的には以下のように変更していきます。
<ApiDefinitions.cs>
・string は NSString に変更
・***Delegate @***Delegate という引数名称を ***Delegate @p1 というカンジで名称変更
・[Verify]は全てコメントアウト
・[Static]も場合によりコメントアウト
<StructsAndEnums.cs>
・nint は long に変更
・enum は public enum に変更
６．ビルドプロパティ
バインドライブラリプロジェクトのプロパティを設定します。バインドライブラリ→プロパティ→ビルド→「コードの最適化」のチェックをONにします。
この設定をしないと実行時に「Invalid IL code in SDKView:.ctor (CoreGraphics.CGRect,bool): IL_002b: stloc.0」というようなエラーが発生する場合があります。
７．ビルドと参照設定
（１）BindLibraryプロジェクトをビルドします。（２）iOSプロジェクト（アプリ側）からビルドしたBindLibraryプロジェクトまたはビルドしたDLLを参照設定します。
８．実装例
実際にバインドライブラリを用いた作成例を以下の記事でご紹介しておりますので、ご参考にしてください。「nendでバナー広告を表示する方法 -iOS編-」
「忍者AdMaxでバナー広告を表示する方法 -iOS編-」
最後までお読みいただきありがとうございます。
当ブログの内容をまとめた Xamarin逆引きメニュー は以下のURLからご覧になれます。
https://itblog.dynaspo.com/blog-entry-81.html
