ApiDefinitions & StructsAndEnums Files

Quando Objective Sharpie è stato eseguito correttamente, genera Binding/ApiDefinitions.cs file e Binding/StructsAndEnums.cs . Questi due file vengono aggiunti a un progetto di associazione in Visual Studio per Mac o passati direttamente agli btouch strumenti o bmac per produrre l'associazione finale.

In alcuni casi questi file generati potrebbero essere tutti necessari, ma più spesso lo sviluppatore dovrà modificare manualmente questi file generati per risolvere eventuali problemi che non possono essere gestiti automaticamente dallo strumento (ad esempio quelli contrassegnati con un Verify attributo).

Alcuni dei passaggi successivi includono:

• Modifica dei nomi: a volte è necessario modificare i nomi dei metodi e delle classi in modo che corrispondano alle linee guida per la progettazione di .NET Framework.
• Metodi o proprietà: l'euristica usata da Objective Sharpie a volte selezionerà un metodo da trasformare in una proprietà. A questo punto, è possibile decidere se si tratta o meno del comportamento previsto.
• Associare eventi: è possibile collegare le classi alle classi delegate e generare automaticamente eventi per tali classi.
• Associare le notifiche: non è possibile estrarre il contratto API delle notifiche dai file di intestazione puri. Questa operazione richiederà un viaggio nella documentazione dell'API. Se si vogliono notifiche fortemente tipate, è necessario aggiornare il risultato.
• Curation API: a questo punto, è possibile scegliere di fornire costruttori aggiuntivi, aggiungere metodi (per consentire l'inizializzazione in C# nella sintassi di costruzione), overload degli operatori e implementare le proprie interfacce nel file di definizioni aggiuntive.

Vedere la descrizione dell'associazione di un'API per vedere come questi file rientrano nel processo di associazione, come illustrato nel diagramma seguente:

Per altre informazioni sul contenuto di questi file, vedere le informazioni di riferimento sui tipi di associazione.