Objective Sharpie のツールとコマンド

[アーティクル]
04/23/2024

Objective Sharpie に含まれるツールの概要と、それらで使うためのコマンドライン引数。

Objective Sharpie が正常にインストールされたら、ターミナルを開き、Objective Sharpie で提供される "コマンド" について理解してください。

$ sharpie -help
usage: sharpie [OPTIONS] TOOL [TOOL_OPTIONS]

Options:
  -h, -help                Show detailed help
  -v, -version             Show version information

Telemetry Options:
  -tlm-about               Show a detailed overview of what usage and binding
                             information will be submitted to Xamarin by
                             default when using Objective Sharpie.
  -tlm-do-not-submit       Do not submit any usage or binding information to
                             Xamarin. Run 'sharpie -tml-about' for more
                             information.
  -tlm-do-not-identify     Do not submit Xamarin account information when
                             submitting usage or binding information to Xamarin
                             for analysis. Binding attempts and usage data will
                             be submitted anonymously if this option is
                             specified.

Available Tools:
  xcode              Get information about Xcode installations and available SDKs.
  pod                Create a Xamarin C# binding to Objective-C CocoaPods
  bind               Create a Xamarin C# binding to Objective-C APIs
  update             Update to the latest release of Objective Sharpie
  verify-docs        Show cross reference documentation for [Verify] attributes
  docs               Open the Objective Sharpie online documentation

Objective Sharpie には次のツールが用意されています。

ツール	説明
xcode	Xcode の現在のインストールと、使用できる iOS と Mac の SDK のバージョンに関する情報を提供します。後でバインドを生成するときにこの情報を使います。
pod	マスター Spec リポジトリから入手できる Objective-CCocoaPod ライブラリの検索、構成、インストール、バインドを行います。このツールは、インストールされている CocoaPod を評価し、次の `bind` ツールに渡す正しい入力を自動的に推測します。 3.0 での新機能です。
bind	Objective-C ライブラリのヘッダーファイル (`*.h`) を解析して、最初の ApiDefinition.cs と StructsAndEnums.cs ファイルを得ます。
update	Objective Sharpie の新しいバージョンを調べて、ある場合はインストーラーをダウンロードして起動します。
verify-docs	`[Verify]` 属性に関する詳細情報を表示します。
docs	既定の Web ブラウザーでこのドキュメントに移動します。

特定の Objective Sharpie ツールに関するヘルプを表示するには、ツールの名前と -help オプションを入力します。たとえば、sharpie xcode -help は次の出力を返します。

$ sharpie xcode -help
usage: sharpie xcode [OPTIONS]

Options:
  -h, -help        Show detailed help
  -v, -verbose     Be verbose with output

Xcode Options:
  -sdks            List all available Xcode SDKs. Pass -verbose for more details.

バインドプロセスを始める前に、ターミナルで sharpie xcode -sdks コマンドを入力して、現在インストールされている SDK に関する情報を取得する必要があります。出力は、インストールされている Xcode のバージョンによって異なる場合があります。 Objective Sharpie は、/Applications ディレクトリの下にあるすべての Xcode*.app でインストールされている SDK を検索します。

$ sharpie xcode -sdks
sdk: appletvos9.0    arch: arm64
sdk: iphoneos9.1     arch: arm64   armv7
sdk: iphoneos9.0     arch: arm64   armv7
sdk: iphoneos8.4     arch: arm64   armv7
sdk: macosx10.11     arch: x86_64  i386
sdk: macosx10.10     arch: x86_64  i386
sdk: watchos2.0      arch: armv7

上記からは、iphoneos9.1 SDK がコンピューターにインストールされており、arm64 アーキテクチャがサポートされていることがわかります。このセクションのすべてのサンプルでこの値を使います。この情報がわかっていると、Objective-C ライブラリヘッダーファイルを解析して、バインドプロジェクト用の最初の ApiDefinition.cs と StructsAndEnums.cs を得られます。

次の方法で共有

Objective Sharpie のツールとコマンド

その他のリソース