Compartir vía


Archivos ApiDefinitions y StructsAndEnums

Cuando Objective Sharpie se ha ejecutado correctamente, genera archivos Binding/ApiDefinitions.cs y Binding/StructsAndEnums.cs. Estos dos archivos se agregan a un proyecto de enlace en Visual Studio para Mac o se pasan directamente a las herramientas de btouch o bmac para generar el enlace final.

En algunos casos, es posible que estos archivos generados sean todos los que necesite, pero con más frecuencia el desarrollador tendrá que modificar manualmente estos archivos generados para corregir los problemas que la herramienta no pudo controlar automáticamente (por ejemplo, los marcados con un atributo Verify).

Algunos de los pasos siguientes incluyen:

  • Ajustar nombres: a veces querrá ajustar los nombres de métodos y clases para que coincidan con las directrices de diseño de .NET Framework.
  • Métodos o propiedades: la heurística usada por Objective Sharpie a veces elegirá un método para convertirse en una propiedad. En este momento, podría decidir si se trata del comportamiento previsto o no.
  • Enlazar eventos: puede vincular las clases con las clases de delegado y generar automáticamente eventos para ellos.
  • Enlazar notificaciones: no es posible extraer el contrato de API de las notificaciones de los archivos de encabezado puros, lo que requerirá un viaje a la documentación de la API. Si desea notificaciones fuertemente tipadas, deberá actualizar el resultado.
  • Conservación de la API: en este momento, puede optar por proporcionar constructores adicionales, agregar métodos (para permitir la sintaxis inicialize-on-construction de C#), sobrecargar e implementar sus propias interfaces en el archivo de definiciones adicionales.

Consulte la descripción de la API de enlace para ver cómo encajan estos archivos en el proceso de enlace, como se muestra en el diagrama siguiente:

The binding process is shown in this diagram

Consulte la referencia de tipos de enlace para obtener más información sobre el contenido de estos archivos.