Wie kann ich Komponenten aus meinen vorhandenen Apps entwickeln?
Eine iOS-Komponente für den Developer Garden Marketplace ist nichts anderes als eine Objective C-Bibliothek, optional gefüllt mit Aufrufen des Developer Garden Licensing SDK, um eure API zu schützen.
Um eure APIs den Entwicklern ordnungsgemäß bereitzustellen, solltet ihr neben einem Simulator-Build auch einen Produktions-Build erzeugen (für ein Zielgerät wie z.B. iPhone, iPad oder iPod Touch). Zusammen mit den binären Dateien (Endung „.a“) braucht ihr auch Header-Dateien (Endung „.h“), damit die Entwickler über eure APIs kompilieren können.
Wenn ihr bereits eine Anwendung habt, könnt ihr den Entwicklern Teile davon als Komponenten bereitstellen. Angenommen, ihr habt z.B. eine Anwendung für Shopping-Vergleiche, mit der Barcodes eingelesen und nach Preisen für ein Produkt gesucht werden kann. Genau dann ist der Barcode-Reader eine nützliche Funktion in dieser Anwendung, die ihr anderen Entwicklern verkaufen könntet. Um diese Funktion als Komponente bereitzustellen, müssen diejenigen Teile isoliert werden, die sich auf das Einlesen des Barcodes beziehen. Legt ein neues Projekt an und bindet die Quelldateien für diese Funktion ein. In XCode erstellt ihr mit der „Cocoa Touch Static Library“ ein neues Projekt. Ihr müsst sicherstellen, dass es beim Einbinden des Codes keine Abhängigkeiten mit anderen Teilen eurer Anwendung gibt. Und denkt daran, dass ihr binäre „.a“-Dateien an die Entwickler verteilt. Es muss sich also um eine eigenständige Komponente handeln, die keine Abhängigkeiten mit der Ursprungsanwendung hat. Sobald ihr eine „.a“-Bibliothek erzeugt habt, solltet ihr Funktionalität und Schnittstellen eurer Komponente zweckentsprechend mit einer kleinen Testanwendung prüfen. Denkt daran, dass ihr diese Testanwendung zusammen mit eurer Komponente im Quellcode beim Developer Garden Marketplace einreicht.
Wenn ihr mit der Komponente zufrieden seid, könnt ihr das Developer Garden Licensing SDK referenzieren, um den Lizenzierungscode in eure Komponente einzubinden. Ihr bindet in eure Anwendung auch einen öffentlichen Schlüssel ein. Fügt in eurer Testanwendung den Code aus dem Lizenz-SDK ein, um einen Probelizenzschlüssel zu übergeben, den ihr vom Developer Garden Marketplace erhalten habt (weitere Einzelheiten findet ihr im Developer Garden Licensing SDK). Die Anwendung sollte mit einem gültigen Lizenzschlüssel ebenso funktionieren wie zuvor. Die API sollte nicht mehr funktionieren, wenn der Lizenzschlüssel geändert wird. Reicht diese Testanwendung, die den Lizenzcode enthält, beim Developer Garden Marketplace ein. Der Developer Garden Marketplace nutzt eure Beispielanwendung, um den Genehmigungsvorgang zu unterstützen.
Abschließend solltet ihr dokumentieren, wie die Komponente zu verwenden ist, sowie eine API-Anleitung beilegen. Die Anleitung sollte alle APIs umfassen, die die Komponente bereitstellt. Wir empfehlen euch dabei, das Open-Source-Tool Doxygen zu verwenden, um auf Basis eurer „.h“-Header-Dateien die Anleitung zu erstellen. Zusätzlich zu der Anleitung solltet ihr auch ein Benutzer-/Entwicklerhandbuch beilegen. Darin solltet ihr u.a. beschreiben, wie die Komponente funktioniert, welche verschieden Funktionen sie besitzt und wie diese Funktionen in einer Anwendung genutzt werden können.
Dieses Dokument sollte als PDF oder im HTML-Format bereitgestellt werden. Unsere Beispielkomponenten bieten eine Anregung zur Erstellung einer zweckmäßigen Dokumentation für eure eigene Komponente.
