Целевые инструменты Sharpie и команды

Общие сведения о средствах, включенных в 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 предоставляет следующие средства:

Средство	Description
Xcode	Предоставляет сведения о текущей установке Xcode и доступных версиях пакетов SDK для iOS и Mac. Мы будем использовать эти сведения позже, когда мы создадим наши привязки.
Pod	Ищет, настраивает, устанавливает (в локальном каталоге) и привязывает Objective-Cбиблиотеки CocoaPod , доступные в репозитории master Spec. Это средство оценивает установленный CocoaPod, чтобы автоматически выводить правильные входные данные для передачи в bind средство ниже. Новые возможности в версии 3.0!
bind	Анализирует файлы заголовков (*.h) в библиотеке Objective-C в исходные ApiDefinition.cs и StructsAndEnums.cs файлы.
обновить	Проверяет наличие более новых версий Objective Sharpie и загружает и запускает установщик, если он доступен.
Verify-docs	Подробные сведения об [Verify] атрибутах.
Документация	Перейдите к этому документу в веб-браузере по умолчанию.

Чтобы получить справку по определенному инструменту 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.

Прежде чем начать процесс привязки, необходимо получить сведения о наших текущих установленных пакетах SDK, введя следующую команду в терминал sharpie xcode -sdks. Выходные данные могут отличаться в зависимости от установленных версий Xcode. Objective Sharpie ищет пакеты SDK, установленные в любом Xcode*.app каталоге /Applications :

$ 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 для проекта привязки.