Настройка привязокCustomizing Bindings

Можно настроить привязку Xamarin. Android, изменив метаданные, управляющие процессом привязки. Эти ручные изменения часто необходимы для устранения ошибок сборки и для формирования результирующего API, чтобы он более соответствовал C#/.нет. В этих руководствах описывается структура этих метаданных, изменение метаданных и использование JavaDoc для восстановления имен параметров метода.You can customize an Xamarin.Android binding by editing the metadata that controls the binding process. These manual modifications are often necessary for resolving build errors and for shaping the resulting API so that it is more consistent with C#/.NET. These guides explain the structure of this metadata, how to modify the metadata, and how to use JavaDoc to recover the names of method parameters.

ОбзорOverview

Xamarin. Android автоматизирует большую часть процесса привязки; Однако в некоторых случаях ручное изменение необходимо для решения следующих проблем.Xamarin.Android automates much of the binding process; however, in some cases manual modification is required to address the following issues:

  • Устранение ошибок сборки, вызванных отсутствием типов, запутанными типами, повторяющимися именами, проблемами видимости класса и другими ситуациями, которые не могут быть разрешены средствами Xamarin. Android.Resolving build errors caused by missing types, obfuscated types, duplicate names, class visibility issues, and other situations that cannot be resolved by the Xamarin.Android tooling.

  • Изменение сопоставления, которое используется Xamarin. Android для привязки API Android к C# различным типам в (например, многие разработчики предпочитают сопоставлять константы Java int с C# enum константами).Changing the mapping that Xamarin.Android uses to bind the Android API to different types in C# (for example, many developers prefer to map Java int constants to C# enum constants).

  • Удаление неиспользуемых типов, которые не должны быть привязаны.Removing unused types that do not need to be bound.

  • Добавление типов, не имеющих аналога в базовом API Java.Adding types that have no counterpart in the underlying Java API.

Некоторые или все эти изменения можно внести, изменив метаданные, управляющие процессом привязки.You can make some or all of these changes by modifying the metadata that controls the binding process.

НаправляющиеGuides

В следующих руководствах описываются метаданные, управляющие процессом привязки, и объясняется, как изменить эти метаданные для решения этих проблем.The following guides describe the metadata that controls the binding process and explain how to modify this metadata to address these issues:

  • Метаданные привязок Java предоставляют общие сведения о метаданных, которые передаются в привязку Java.Java Bindings Metadata provides an overview of the metadata that goes into a Java binding. В нем описываются различные ручные действия, которые иногда требуются для завершения работы с библиотекой привязки Java, и объясняется, как сформировать API, предоставляемый привязкой, для более тщательного соблюдения руководств по проектированию .NET.It describes the various manual steps that are sometimes required to complete a Java binding library, and it explains how to shape an API exposed by a binding to more closely follow .NET design guidelines.

  • Именование параметров с помощью Javadoc объясняет, как восстановить имена параметров в проекте привязки Java с помощью Javadoc, созданного из связанного проекта Java.Naming Parameters with Javadoc explains how to recover parameter names in a Java Binding Project by using Javadoc produced from the bound Java project.