Настройка привязок
Привязку Xamarin.Android можно настраивать, изменив метаданные, управляющие процессом привязки. Эти ручные изменения часто необходимы для устранения ошибок сборки и для формирования результирующего API, таким образом, чтобы он больше соответствовал C#/.NET. В данном руководстве объясняется структура этих метаданных, как модифицировать метаданные и как использовать JavaDoc для восстановления имен параметров метода.
Обзор
Xamarin.Android автоматизирует большую часть процесса привязки; однако в некоторых случаях для решения приведенных ниже проблем необходимо ручное изменение.
Устранение ошибок сборки, вызванных отсутствием типов, непонятными типами, повторяющимися именами, проблемами видимости класса и другими ситуациями, которые не могут быть разрешены средствами Xamarin.Android.
Изменение сопоставления, которое используется Xamarin.Android для привязки API Android к различным типам в C# (например, многие разработчики предпочитают сопоставлять константы Java
int
с константами C#enum
).Удаление неиспользуемых типов, которые не нуждаются в привязке.
Добавление типов, не имеющих аналога в базовом API Java.
Некоторые или все эти изменения можно внести, изменив метаданные, управляющие процессом привязки.
Guides
В следующих руководствах описываются метаданные, управляющие процессом привязки, и объясняется, как изменить эти метаданные для решения этих проблем.
Метаданные привязок Java предоставляют общие сведения о метаданных, которые передаются в привязку Java. В нем описываются различные действия вручную, которые иногда требуются для завершения работы с библиотекой привязки Java, и объясняется, как сформировать API, предоставляемый привязкой, чтобы более точно следовать руководству по проектированию .NET.
Именование параметров с помощью Javadoc объясняет, как восстановить имена параметров в проекте привязки Java с помощью Javadoc, созданного из связанного проекта Java.