DokumentationAutomatisierung
Andere CI-Systeme
Jenkins, Xcode Cloud, Bitrise, Codemagic, CircleCI, Azure Pipelines und Buildkite: wo das vitrine-Werkzeug hingehört und wo seine Berichte erscheinen.
Jedes CI-System kann das Kommandozeilenwerkzeug vitrine ausführen:
entweder im Container-Image oder aus dem Archiv für deinen Runner (beides
unter Automatisierung). Die Schritte sind
überall gleich – vitrine validate, vitrine export und für Releases
vitrine upload (Hochladen aus der CI). Unterschiede
gibt es nur dabei, wo die Berichte landen. Läuft in deiner Pipeline fastlane,
kannst du Vitrine Studio auch aus der Lane aufrufen: fastlane.
Jenkins
Führe die Schritte im Container-Image aus oder installiere das Archiv auf dem
Agent. Den JUnit-Bericht veröffentlichst du mit dem junit-Schritt:
pipeline {
agent { docker { image 'ghcr.io/vitrinestudio-app/vitrine-cli:1.0.0' } }
stages {
stage('Store screenshots') {
steps {
sh 'vitrine --project store-screens validate --format junit -o vitrine-junit.xml'
sh 'vitrine --project store-screens export --out export --no-gallery'
}
}
}
post {
always {
junit 'vitrine-junit.xml'
archiveArtifacts artifacts: 'export/**'
}
}
}
Xcode Cloud
Installiere das macOS-Archiv in ci_scripts/ci_post_clone.sh – ohne sudo,
in einen Ordner im Workspace – und prüfe oder exportiere dann in
ci_scripts/ci_post_xcodebuild.sh.
Bitrise
Füge einen Script-Schritt hinzu, der das Archiv installiert (macOS- oder
Linux-Stack), und rufe danach vitrine auf. Für den Testbericht schreibst du
die JUnit-Datei mit einer test-info.json nach
$BITRISE_TEST_RESULT_DIR/vitrine/ und fügst Deploy to Bitrise.io hinzu.
Codemagic
Füge einen scripts:-Eintrag hinzu, der das Archiv installiert. Für Uploads
gibst du die App-Store-Connect-Variablen von Codemagic unter unseren Namen an
vitrine weiter:
scripts:
- name: Upload store screenshots
script: |
export VITRINE_ASC_KEY="$APP_STORE_CONNECT_PRIVATE_KEY"
export VITRINE_ASC_KEY_ID="$APP_STORE_CONNECT_KEY_IDENTIFIER"
export VITRINE_ASC_ISSUER_ID="$APP_STORE_CONNECT_ISSUER_ID"
vitrine --project store-screens upload plan --store apple --remote --format json > plan.json
vitrine --project store-screens upload execute --confirm "$(jq -r .confirm_token plan.json)" --yes
CircleCI, Azure Pipelines, Buildkite
Nimm das Container-Image oder das Archiv. Den JUnit-Bericht veröffentlichst
du mit store_test_results (CircleCI), PublishTestResults@2 im Format
JUnit (Azure) oder als Buildkite-Annotation.