Übung: Dienst „Xcode“ einrichten

Im Folgenden wird davon ausgegangen, dass Sie als Entwickler Xcode bereits auf einem Mac installiert haben und Ihnen ein installiertes Code-Repository (speziell ein Git-Repository) zur Verfügung steht.

Die Lerninhalte dieser Übung sind:

  • Dienst „Xcode“ einrichten

  • Git-Repository hosten

  • Xcode für die Interaktion mit dem Xcode-Dienst konfigurieren

  • Bot für nächtlichen Build-Prozess („Nightly Build“) erstellen

  • Ausgabe des Bot in der Web-App überprüfen

Schritt 1: Xcode auf den Server laden und installieren

Damit Sie den Dienst „Xcode“ nutzen können, müssen Sie (sofern noch nicht geschehen) Xcode auf dem Server installieren.

  • Laden Sie Xcode aus dem App Store und installieren Sie die Software auf dem Server.

Schritt 2. Dienst „Xcode“ in der Server-App konfigurieren

  1. Öffnen Sie die Server-App, um die Liste der von OS X Server bereitgestellten Dienste anzuzeigen. Wählen Sie „Xcode“ aus.

  2. Klicken Sie auf „Xcode auswählen“ und wählen Sie „Xcode“ im Ordner „Programme“ aus. Der Dienst „Xcode“ wird automatisch gestartet.

    Pfeil, der auf die Taste „Xcode auswählen“ zeigt

Schritt 3. Git-Repository erstellen

Die Bots des Xcode-Dienstes greifen auf Projekte und Code in Ihrem als Quelle fungierenden Git-Repository zu.

  • Klicken Sie auf „Repositories“ und danach auf „Hinzufügen“ Hinzufügen. Wählen Sie einen Namen für das Git-Repository und klicken Sie auf „Erstellen“.

    Die URL für das Repository basiert auf dem Hostnamen des Servers und dem Namen des Repository. Die URL des Beispiel-Repository wäre https://myserver.example.com/git/Mac_Calc.git.

    Pfeil der auf „Repositories hinzufügen“ zeigt

Wenn Sie bereits ein Git-Repository verwenden, können Sie mit Xcode die Dateien in das neu gehostete Repository kopieren.

Schritt 4. Dienst aktivieren

  • Klicken Sie auf die Taste, um den Xcode-Dienst zu aktivieren.

    Dienst-Taste aktiviert

Schritt 5. Xcode öffnen und Server im Bereich „Accounts“ hinzufügen

Xcode 5 kann die Verbindung zu Servern herstellen, auf denen der Xcode-Dienst ausgeführt wird.

  • Klicken Sie im Bereich mit den Xcode-Einstellungen auf „Accounts“ und danach auf „Hinzufügen“ Hinzufügen, um einen Server-Account hinzuzufügen.

    Wählen Sie danach den Server aus und melden Sie sich unter Verwendung Ihres Server-Accounts an.

Schritt 6. Bot für nächtlichen Build-Prozess („Nightly Build“) erstellen

Veranlassen Sie, sofern noch nicht geschehen, dass das Projekt in Xcode ausgecheckt wird.

Sie können Bots auch mit der Web-App des Xcode-Diensts erstellen.

  1. Vergewissern Sie sich in Ihrem Projekt, dass „Shared“ als „Scheme“ definiert ist.

    Wenn dies nicht der Fall ist, erhalten Sie von Xcode die Gelegenheit, das Schema freizugeben und bereitzustellen.

  2. Wählen Sie „Product“ > „Create Bot“ und folgen Sie den auf dem Bildschirm angezeigten Anweisungen.

  3. Wählen Sie zunächst das Schema und danach den Server aus („meinserver.local“ in diesem Beispiel). Geben Sie einen Namen für den Bot ein („Mac_Calc Bot“) und klicken Sie auf „Next“.

  4. Geben Sie (sofern erforderlich) die Authentifizierungseinstellungen für Ihr Repository ein.

  5. Legen Sie die „Schedule“- und „Action“-Einstellungen fest.

    Verwenden Sie für „Schedule“ eine der folgenden Einstellungen: „Periodically“, „Daily“ und „at midnight“. Wählen Sie nur „Perform archive“ für die Option „Action“ aus.

  6. Legen Sie die „Email“-Einstellungen fest.

    Achten Sie darauf, dass das Feld „Failure email notification“ markiert ist und fügen Sie der Liste „Failure notification“ Ihre eigene E-Mail-Adresse hinzu.

  7. Klicken Sie auf „Create Bot“.

Schritt 7. Bot-Bericht in Safari anzeigen

  • Öffnen Sie Safari, geben Sie die URL „https://meinserver.local/xcode/“ ein und wählen Sie in der Liste aller Bots den neu erstellten Bot aus.

    Site der Safari-Botliste

Schritt 8. Integrationsaktion in Xcode mit dem Bot ausführen und Ergebnisse in Safari anzeigen

  • Starten Sie die Integrationsaktion in Xcode vor dem mit der Option „Schedule“ geplanten Zeitpunkt, indem Sie auf die Taste „Integrate“ klicken.

Herzlichen Glückwunsch!

Sie wissen nun, wie Sie den Xcode-Dienst einrichten, einen Bot erstellen und in Safari den Bot-Fortschritt verfolgen können.

Weitere Informationen

Es gibt noch viel Wissenswertes rund um die Workflows für die Softwareentwicklung und Softwareintegration. Weitere Informationen über diese Workflows und die Xcode-App finden Sie auf der Website von Apple für Entwickler.

Weitere Informationen über die kontinuierliche Integration finden Sie unter Xcode Continuous Integration Guide.

Weitere Informationen zum Dienst „Xcode“ finden Sie in der Server-Hilfe.

Interessant ist in diesem Zusammenhang auch die Möglichkeit, über das Internet sicher auf ein privates Intranet zuzugreifen. Weitere Informationen hierzu finden Sie unter Konfigurieren des öffentlichen Zugangs.