Целевые атрибуты Sharpie
Часто вы найдете, что привязки, созданные Objective Sharpie, будут аннотированы атрибутом [Verify] . Эти атрибуты указывают на то, что вы должны убедиться , что Objective Sharpie сделал правильное действие, сравнивая привязку с исходным объявлением C/Objective-C (которое будет предоставлено в комментарии выше ограничивающего объявления).
Проверка рекомендуется для всех ограничивающих объявлений, но, скорее всего, требуется для объявлений, аннотированных атрибутом[Verify]. Это связано с тем, что во многих ситуациях в исходном исходном коде недостаточно метаданных, чтобы определить, как лучше всего создать привязку. Возможно, вам потребуется ссылаться на документацию или комментарии кода в файлах заголовков, чтобы принять оптимальное решение о привязке.
Убедившись, что привязка правильна или исправлена, [Verify] удалите атрибут из привязки.
Внимание
[Verify] атрибуты намеренно вызывают ошибки компиляции C#, чтобы принудительно проверить привязку. При проверке (и возможно исправлении) кода необходимо удалить [Verify] атрибут.
Справка по подсказкам
Аргумент указания, предоставленный атрибуту, можно перекрестно ссылаться на документацию ниже. Документация по любым созданным [Verify] атрибутам будет предоставлена в консоли, а также после завершения привязки.
[Verify] Подсказка |
Description |
|---|---|
| InferredFromPreceedingTypedef | Имя этого объявления было выведено общим соглашением из непосредственно предыдущего typedef в исходном исходном коде. Убедитесь, что указанное имя правильно, так как это соглашение неоднозначно. |
| ConstantsInterfaceAssociation | Нет способа обмана определить, с каким Objective-C интерфейсом может быть связано объявление экстерна переменной. Экземпляры этих элементов привязаны как [Field] свойства в частичном интерфейсе к конкретному интерфейсу для создания более интуитивно понятного API, возможно, полностью устраняя интерфейс "Константы". |
| MethodToProperty | Метод Objective-C был привязан как свойство C# из-за соглашения, например принятия параметров и возврата значения (непустый возврат). Часто такие методы должны быть привязаны как свойства к поверхности более удобного API, но иногда могут возникать ложные срабатывания, и привязка должна быть фактически методом. |
| StronglyTypedNSArray | Родной NSArray* был привязан как NSObject[]. Можно было бы более строго ввести массив в привязке на основе ожиданий, заданных с помощью документации ПО API (например, примечания в файле заголовка) или путем изучения содержимого массива с помощью тестирования. Например, объект NSArray* со только экземпляром NSNumber* должен быть привязан NSNumber[] вместо NSObject[]него. |
Вы также можете быстро получить документацию по подсказке sharpie verify-docs с помощью средства, например:
sharpie verify-docs InferredFromPreceedingTypedef