ApiDefinitions & StructsAndEnums Files

Wenn Objective Sharpie erfolgreich ausgeführt wurde, generiert Binding/ApiDefinitions.cs sie und Binding/StructsAndEnums.cs Dateien. Diese beiden Dateien werden einem Bindungsprojekt in Visual Studio für Mac hinzugefügt oder direkt an die btouch Oder bmac Tools übergeben, um die endgültige Bindung zu erzeugen.

In einigen Fällen sind diese generierten Dateien möglicherweise alles, was Sie benötigen, aber häufiger muss der Entwickler diese generierten Dateien manuell ändern, um Probleme zu beheben, die nicht automatisch vom Tool behandelt werden konnten (z. B. diejenigen, die mit einem Verify Attribut gekennzeichnet sind).

Einige der nächsten Schritte umfassen:

• Anpassen von Namen: Manchmal möchten Sie die Namen von Methoden und Klassen entsprechend den .NET Framework-Entwurfsrichtlinien anpassen.
• Methoden oder Eigenschaften: Die von Objective Sharpie verwendeten Heuristiken wählen manchmal eine Methode aus, die in eine Eigenschaft umgewandelt werden soll. An diesem Punkt können Sie entscheiden, ob dies das beabsichtigte Verhalten ist.
• Verknüpfen von Ereignissen: Sie können Ihre Kurse mit Ihren Delegatenklassen verknüpfen und automatisch Ereignisse für diese generieren.
• Benachrichtigungen verbinden: Es ist nicht möglich, den API-Vertrag von Benachrichtigungen aus den reinen Headerdateien zu extrahieren, dies erfordert eine Reise in die API-Dokumentation. Wenn Sie stark typierte Benachrichtigungen benötigen, müssen Sie das Ergebnis aktualisieren.
• API-Curation: An diesem Punkt können Sie zusätzliche Konstruktoren bereitstellen, Methoden hinzufügen (um C#-Initialize-on-Construction-Syntax zuzulassen), Operatorüberladungen und Implementieren Eigener Schnittstellen in der zusätzlichen Definitionsdatei.

Sehen Sie sich die Bindung einer API-Beschreibung an, um zu sehen, wie diese Dateien in den Bindungsprozess passen, wie im folgenden Diagramm dargestellt:

Weitere Informationen zum Inhalt dieser Dateien finden Sie in der Bindungstypenreferenz .