Signera en mobilapp

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Om du vill signera och etablera en mobilapp för Android- eller Apple-operativsystem måste du hantera signeringscertifikat och Apple-etableringsprofiler. Den här artikeln beskriver hur du på ett säkert sätt hanterar certifikat och profiler för signering och etablering av din app i Azure Pipelines.

Kommentar

Du behöver minst en agent för att köra en version eller version. Du kan använda en Microsoft-värdbaserad Linux-, macOS- eller Windows-byggagent eller konfigurera din egen agent. Mer information finns i Skapa och släppa agenter.

Signera din Android-app

Följ de här stegen för att signera din Android-app samtidigt som du håller signeringscertifikatet säkert.

Ladda upp keystore-filen

1. Hämta en nyckellagringsfil som innehåller ditt signeringscertifikat. Android-dokumentationen beskriver processen för att generera en nyckelarkivfil och dess motsvarande nyckel.

2. I Azure Pipelines går du till Bibliotek>Säkra filer. Välj + Säker fil och ladda upp nyckelarkivfilen till biblioteket för säkra filer. Under uppladdningen krypteras och lagras nyckelarkivet på ett säkert sätt.

Lägg till signeringsuppgiften i pipelinen

YAML

Lägg till den AndroidSigning@3 uppgiften i YAML-pipelinen efter steget som skapar din app. I uppgiften AndroidSigning@3 :

• <apkFiles> krävs och är sökvägen och namnen på de APK-filer som ska signeras. Standardvärdet är **/*.apk.
• <apksign> måste vara true, vilket är standardvärdet.
• <keystore-file> är namnet på den uppladdade nyckellagringsfilen i biblioteket för säkra filer.
• <apksignerKeystorePassword> är lösenordet till den okrypterade nyckellagringsfilen.
• <apksignerKeystoreAlias> är nyckelaliaset för signeringscertifikatet.
• <apksignerKeyPassword> är lösenordet för nyckeln som är associerad med det angivna aliaset.

Du kan ange och använda variabler i YAML, eller så kan du ange variablerna med hjälp av fliken Variabler i Azure Pipelines-användargränssnittet och referera till dem i YAML.

variables:
  keystore-password: <keystore file password>
  key-alias: <key alias for the signing certificater>
  key-password: <password for the key associated with the alias>

steps:
- task: AndroidSigning@3
  displayName: 'Signing and aligning APK file(s) **/*.apk'
  inputs:
    apkFiles: '**/*.apk'
    apksign: true
    apksignerKeystoreFile: <keystore-filename.keystore>
    apksignerKeystorePassword: $(keystore-password)
    apksignerKeystoreAlias: $(key-alias)
    apksignerKeyPassword: $(key-password)

Klassisk

1. Skapa din byggpipeline från android- eller Xamarin.Android-byggmallen. Eller om du redan har en bygg-pipeline kontrollerar du att Android-signeringsaktiviteten finns efter uppgiften som skapar din app.

2. I Android-signeringsuppgiften väljer du kryssrutan Signera APK under Signeringsalternativ.

3. Välj inställningsikonen bredvid fältet Keystore-fil och välj den uppladdade nyckelarkivfilen i listrutan Keystore-fil .

4. Välj fliken Variabler för pipelinen och lägg till följande variabler:

   Name	Värde
   keystore-password	Lösenord till den okrypterade nyckellagringsfilen. Se till att välja låsikonen för att skydda lösenordet och dölja det i loggar.
   nyckelalias	Nyckelaliaset för signeringscertifikatet som du genererade.
   nyckellösenord	Lösenordet för nyckeln som är associerad med det angivna aliaset. Se till att välja låsikonen.

   

5. På fliken Uppgifter väljer du Android-signeringsaktiviteten och refererar till namnen på de nyligen skapade variablerna i signeringsalternativen som $(keystore-password), $(key-alias)och $(key-password).

   

Alla byggagenter kan nu signera din app på ett säkert sätt utan någon certifikathantering på själva byggdatorn.

Signera din Apple iOS-, macOS-, tvOS- eller watchOS-app

För att signera och etablera din app behöver Xcode- eller Xamarin.iOS-versionen åtkomst till ditt P12-signeringscertifikat och en eller flera etableringsprofiler. Följande steg beskriver hur du hämtar dessa filer.

Hämta ditt P12-signeringscertifikat

1. Exportera utvecklings- eller distributionssigneringscertifikatet till en .p12-fil med hjälp av Xcode eller nyckelringsåtkomstappen på macOS.

   • Så här exporterar du med Xcode:

     1. Gå till Xcode-inställningskonton>>.

     2. I den vänstra kolumnen väljer du ditt Apple-ID.

     3. Till höger väljer du ditt personliga konto eller teamkonto och väljer Hantera certifikat.

     4. Ctrl+Välj det certifikat som du vill exportera och välj Exportera certifikat på menyn.

        

     5. I dialogrutan anger du certifikatnamnet, platsen där filen ska sparas och ett lösenord för att skydda certifikatet.

   • Du kan också använda proceduren som beskrivs i iOS-signering för att följa en liknande process med hjälp av nyckelringsåtkomstappen i macOS eller generera ett signeringscertifikat i Windows.

2. Ladda upp P12-filen till azure pipelines-biblioteket för säkra filer. Under uppladdningen krypteras och lagras certifikatet på ett säkert sätt.

3. I pipelinen går du till fliken Variabler och lägger till en variabel med namnet P12password med certifikatlösenordet som värde. Se till att välja låsikonen för att skydda lösenordet och dölja det i loggar.

Hämta din etableringsprofil

Om din app inte använder automatisk signering kan du ladda ned din appetableringsprofil från Apple Developer-portalen. Mer information finns i Redigera, ladda ned eller ta bort etableringsprofiler.

Du kan också använda Xcode för att komma åt etableringsprofiler som är installerade på din Mac. I Xcode går du till Xcode-inställningskonton>>. Välj ditt Apple-ID och ditt team och välj sedan Ladda ned manuella profiler.

I Azure Pipelines laddar du upp etableringsprofilen till biblioteket för säkra filer. Under uppladdningen krypteras och lagras filen på ett säkert sätt.

Lägg till signerings- och etableringsuppgifterna i pipelinen

Om du vill signera och etablera din app kan du antingen installera certifikatet och profilen under varje version eller förinstallera filerna på en macOS-byggagent.

Installera certifikatet och profilen under varje version

Installera certifikatet och profilen under varje version när du inte har varaktig åtkomst till byggagenten, till exempel när du använder värdbaserade macOS-agenter. P12-certifikatet och etableringsprofilen installeras i början av bygget och tas bort när bygget är klart.

YAML

• Lägg till den InstallAppleCertificate@2 aktiviteten i YAML-pipelinen före Xcode- eller Xamarin.iOS-aktiviteten. I koden ersätter du <secure-file.p12> med namnet på den uppladdade .p12-filen . Använd variabeln för den säkra P12password.

  - task: InstallAppleCertificate@2
      inputs:
        certSecureFile: '<secure-file.p12>'
        certPwd: '$(P12password)'
  

  Kommentar

  I aktiviteten InstallAppleCertificate@2 är parametern deleteCert standardvärdet true, vilket tar bort certifikatet efter bygget.

• Lägg till den InstallAppleProvisioningProfile@1 uppgiften i YAML före Xcode- eller Xamarin.iOS-aktiviteten. Ersätt <secure-file.mobileprovision> med namnet på din etableringsprofilfil.

  - task: InstallAppleProvisioningProfile@1
      inputs:
        provProfileSecureFile: '<secure-file.mobileprovision>'
  

  Kommentar

  I aktiviteten InstallAppleProvisioningProfile@1 är parametern removeProfile standardvärdet true, vilket tar bort profilen efter bygget.

Klassisk

• Lägg till uppgiften Installera Apple-certifikat i din version före Xcode- eller Xamarin.iOS-aktiviteten.

  I aktivitetsinställningarna för Installera Apple-certifikat :

  • Bredvid fältet Certifikat (P12) väljer du det uppladdade certifikatet i listrutan Certifikat (P12 ).
  • I fältet Certifikatlösenord (P12) refererar du till variabeln $(P12password).

• Lägg till uppgiften Installera Apple Provisioning Profile i din version före Xcode- eller Xamarin.iOS-aktiviteten.

  I aktivitetsinställningarna installera Apple Provisioning Profile :

  • För alternativet Etableringsprofilplats väljer du Säkra filer och väljer den uppladdade filen i listrutan Etableringsprofil.
  • Markera kryssrutan Ta bort profil efter bygget för att säkerställa att etableringsprofilen inte finns kvar på agentdatorn.

Alla byggagenter kan nu signera din app på ett säkert sätt utan certifikat- eller profilhantering på själva byggdatorn.

Förinstallera certifikatet och profilen på en macOS-byggagent

I stället för att installera signeringscertifikatet och etableringsprofilerna under bygget kan du förinstallera dem på en macOS-byggagent. Filerna är sedan tillgängliga för fortsatt användning av versioner. Använd endast den här metoden när du litar på de personer och processer som har åtkomst till macOS-nyckelringen på agentdatorn.

Förinstallera P12-certifikatet

1. Om du vill installera P12-certifikatet i standardnyckelringen kör du följande kommando från ett macOS-terminalfönster på byggagenten. Ersätt <certificate.p12> med sökvägen och namnet på P12-filen. Ersätt <password> med krypteringslösenordet för P12-filen.

   sudo security import <certificate.p12> -P <password>
   

2. Lägg till en ny variabel i pipelinen med namnet KEYCHAIN_PWD. Ange värdet som lösenord till standardnyckelringen, vilket normalt är lösenordet för den användare som startar agenten. Se till att du väljer låsikonen för att skydda lösenordet.

Förinstallera etableringsprofilen

1. Hitta det fullständiga namnet på din signeringsidentitet genom att öppna ett macOS-terminalfönster och ange security find-identity -v -p codesigning. Du ser en lista över signeringsidentiteter i formuläret iPhone Developer/Distribution: Developer Name (ID). Om en identitet är ogiltig ser du något som liknar (CSSMERR_TP_CERT_REVOKED) efter identiteten.

2. Om du vill installera etableringsprofilen på agentdatorn kör du följande kommando från ett macOS-terminalfönster. Ersätt <profile> med sökvägen till etableringsprofilfilen och ersätt <UUID> med etableringsprofilen UUID, som är filnamnet för etableringsprofilen .mobileprovision utan tillägget.

   sudo cp <profile> ~/Library/MobileDevice/Provisioning Profiles/<UUID>.mobileprovision
   

Lägg till signerings- och etableringsuppgifter som använder standardnyckelringen

YAML

• Lägg till den InstallAppleCertificate@2 aktiviteten i YAML-pipelinen före Xcode- eller Xamarin.iOS-aktiviteten. I koden anger du följande värden:

  • certSecureFile: Namnet på den uppladdade .p12-filen .
  • certPwd: Variabeln för den säkra P12password.
  • signingIdentity: Det fullständiga namnet på din signeringsidentitet.
  • keychain: default, för att tillåta åtkomst till standardnyckelringen.
  • keychainPassword: Variabeln KEYCHAIN_PWD .
  • deleteCert: false, för att behålla certifikatet mellan versioner.

  - task: InstallAppleCertificate@2
    inputs:
      certSecureFile: '<secure-file.p12>'
      certPwd: '$(P12password)'
      signingIdentity: <full-signing-identity>
      keychain: default
      keychainPassword: `$(KEYCHAIN_PWD)
      deleteCert: false
  

• Lägg till InstallAppleProvisioningProfile@1 uppgift. I koden:

  • Ange provProfileSecureFile namnet på etableringsprofilfilen.
  • Ange removeProfile till så att false profilen behålls mellan versioner.

  - task: InstallAppleProvisioningProfile@1
      inputs:
        provProfileSecureFile: '<secure-file.mobileprovision>'
        removeProfile: false
  

Klassisk

• Lägg till uppgiften Installera Apple-certifikat i din version före Xcode- eller Xamarin.iOS-aktiviteten. I aktivitetsinställningarna för Installera Apple-certifikat :

  • Bredvid fältet Certifikat (P12) väljer du det uppladdade certifikatet i listrutan Certifikat (P12 ).
  • I fältet Certifikatlösenord (P12) refererar du till variabeln $(P12password).
  • Under Avancerat anger du Nyckelring till Standardnyckelkedja.
    • Ange nyckelringslösenordet till nyckelringslösenordvariabeln.
    • Avmarkera kryssrutan Ta bort certifikat från nyckelringen för att behålla certifikatet på agentdatorn efter bygget.

• Lägg till uppgiften Installera Apple Provisioning Profile i din version före Xcode- eller Xamarin.iOS-aktiviteten. I aktivitetsinställningarna installera Apple Provisioning Profile :

  • För alternativet Etableringsprofilplats väljer du Säkra filer och väljer den uppladdade filen i listrutan Etableringsprofil.
  • Avmarkera kryssrutan Ta bort profil efter bygge för att behålla etableringsprofilen på agentdatorn efter bygget.

MacOS-byggagenten kan nu signera och etablera appen på ett säkert sätt för alla versioner utan ytterligare certifikat- eller profilhantering.

Referera till de säkra filerna i Xcode- eller Xamarin.iOS-bygguppgiften

Om du vill använda det säkra certifikatet och profilen i dina pipelines konfigurerar du följande inställningar i dina Xcode- eller Xamarin.iOS-bygguppgifter.

Referenserna för säkra filer i bygguppgifterna använder variabler för signingIdentity och provisioningProfileUuid. Dessa variabler anges automatiskt av uppgifterna Installera Apple-certifikat och Installera Apple-etableringsprofil för certifikatet och etableringsprofilen som du har valt.

YAML

För Xcode:

- task: Xcode@5
  inputs:
    signingOption: 'manual'
    signingIdentity: '$(APPLE_CERTIFICATE_SIGNING_IDENTITY)'
    provisioningProfileUuid: '$(APPLE_PROV_PROFILE_UUID)'

För Xamarin.iOS:

- task: XamariniOS@2
    inputs:
      solutionFile: '**/*.iOS.csproj'
      signingIdentity: '$(APPLE_CERTIFICATE_SIGNING_IDENTITY)'
      signingProvisioningProfileID: '$(APPLE_PROV_PROFILE_UUID)'

Klassisk

För aktivitetsinställningarna för Xcode :

• För alternativet Signeringsformat väljer du Manuell signering.
• I fältet Signeringsidentitet anger du $(APPLE_CERTIFICATE_SIGNING_IDENTITY).
• I fältet Etableringsprofil UUID anger du $(APPLE_PROV_PROFILE_UUID).

För aktivitetsinställningarna för Xamarin.iOS :

• För alternativet Åsidosätt med hjälp av väljer du Identifierare.
• I fältet Signeringsidentitet anger du $(APPLE_CERTIFICATE_SIGNING_IDENTITY).
• I fältet Etableringsprofil UUID anger du $(APPLE_PROV_PROFILE_UUID).

Pipeline build-agenten signerar och etablerar appen på ett säkert sätt utan ytterligare certifikat- eller profilhantering på själva byggdatorn.

Relaterat innehåll

Mer information om:

• Pipelines för Android-appar finns i Skapa, testa och distribuera Android-appar.
• Pipelines för iOS-appar finns i Skapa, testa och distribuera Xcode-appar.
• Agenter, se Azure Pipelines-agenter.
• Agentpooler och köer finns i Skapa och hantera agentpooler.
• Variabler i pipelines finns i Definiera variabler.
• Felsökning av pipeline finns i Felsöka pipelinekörningar.