Apparaatregistratie en opnieuw ondertekenen van apps

Op deze pagina kunt u lezen over de stappen die u moet uitvoeren bij het distribueren van een iOS-toepassing naar specifieke testers. Leer wat apparaatregistratie, apparaatconfiguratie en het opnieuw ondertekenen van apps inhoudt. U kunt ook leren hoe u App Center-functionaliteit gebruikt om dit proces zo pijnloos mogelijk te maken. Ten slotte zijn er oplossingen voor enkele veelvoorkomende problemen die u kunt tegenkomen.

App-ondertekening, opnieuw ondertekenen en apparaatinrichting

Ontwikkelaars ondertekenen apps voor beveiliging zoals vereist door Apple bij het distribueren. De vereiste is hetzelfde voor distributie via Xcode, App Center of de iTunes Store. Ondertekening van code is een voorzorgsmaatregel om ervoor te zorgen dat niemand met uw app heeft geknoeid. Meer informatie vindt u in de Apple-documentatie over het ondertekenen van apps.

In het volgende diagram ziet u de volledige stroom voor het opnieuw ondertekenen van apps in App Center. Laten we deze stappen nader bekijken.

Opnieuw ondertekenen van apps is alleen van toepassing wanneer u een iOS-app wilt distribueren naar specifieke testapparaten. In het diagram wilt u een app-release distribueren naar de apparaten van Tester 1 en Tester 2. Hiervoor ondertekent u uw app met een ad-hoc inrichtingsprofiel. Dit inrichtingsprofiel heeft een lijst met unieke apparaat-id's (UDID's). Alleen apparaten die zich in die lijst bevinden, zijn geconfigureerd of kunnen de .ipa installeren. App Center kan detecteren of een apparaat is ingericht, omdat we de UDID van het apparaat kennen vanaf het moment dat de tester het apparaat voor het eerst heeft geregistreerd bij App Center. Als we detecteren dat het apparaat dat door de tester wordt gebruikt, zich niet in de lijst met ingerichte apparaten bevindt voor de IPA die ze willen downloaden, wordt het bericht 'De ontwikkelaars werken aan een versie voor uw apparaat' weergegeven.

Zodra u weet welke apparaten u wilt gebruiken voor het testen:

1. Registreer de apparaten in uw Apple-ontwikkelaarsaccount.
2. Voeg deze toe aan uw provisioning profile.
3. Genereer een nieuw provisioning-profiel.
4. Download het voorzieningsprofiel.
5. Bouw uw app met dit profiel.

Wanneer er nog een nieuw apparaat wordt weergegeven, zoals het apparaat met UDID 3 in het diagram, herhaalt u deze stappen. Dit kan onhandig zijn en u wilt uw continue integratiesysteem niet wijzigen of de ontwikkelaar vragen om altijd nieuwe apparaten aan het profiel toe te voegen en nieuwe builds uit te brengen. Hier kunt u zich opnieuw aanmelden. Dit betekent dat u een bestaande toepassingsbuild maakt en opnieuw ondertekent (opnieuw ondertekenen) met een ander inrichtingsprofiel, zodat u geen nieuwe build hoeft te maken.

App Center helpt u bij dit proces en kan dit ook automatiseren. Dit zijn de handmatige en automatische stappen die in het diagram worden weergegeven, waarbij het apparaat wordt ingericht met UDID 3. Met App Center kunt u apparaat-id's van testers registreren in uw Apple-ontwikkelaarsaccount, een nieuw inrichtingsprofiel aanmaken en de app vanuit de App Center-portal opnieuw herondertekenen. App Center vereist toegang tot uw Apple-ontwikkelaarsaccount voor het registreren van de apparaten.

Als u handmatig apparaten wilt toevoegen aan een bestaande release, kunt u apparaten registreren op de pagina voor een distributiegroep gebruiken. Zie Apparaatregistratie.

Als u automatisch apparaten wilt toevoegen, schakelt u Apparaten automatisch beheren in onder de instellingen van de distributiegroep. Deze optie kan alleen worden geopend via een distributiegroep op app-niveau en is niet beschikbaar via een globale groep. U kunt toegang krijgen tot een distributiegroep op app-niveau door de app te selecteren in App Center en vervolgens op Distribueren te klikken. Klik onder Distribueren op Groepen en klik vervolgens op de specifieke groep die u wilt beheren. U kunt er ook voor kiezen om automatisch apparaten toe te voegen wanneer u een nieuwe release distribueert. Deze optie bevindt zich in de stap Apparaten in de wizard voor het distribueren van een nieuwe release.

App Center voegt het nieuwe apparaat toe aan de lijst in het inrichtingsprofiel en ondertekent uw app opnieuw met dit inrichtingsprofiel. Het nieuwe apparaat kan nu ook de app installeren. Dit zijn de onderste stappen in het diagram.

Mogelijkheden voor opnieuw ondertekenen

Enkele dingen die u moet weten wanneer u zich opnieuw aanmeldt in App Center:

• Het automatisch beheren van apparaten in groepen werkt alleen voor distributie naar niet-openbare en niet-gedeelde groepen.
• Als u distribueert naar afzonderlijke gebruikers, registreert u hun apparaten handmatig en ondertekent u de app opnieuw. Als u de hulpprogramma's in dit artikel wilt gebruiken, moet u eerst de testers toevoegen aan een groep.
• Als u meerdere groepen aan uw release toevoegt, configureert u elke groep afzonderlijk met behulp van Apparaten automatisch beheren onder de groepsinstellingen.
• Het beheren van apparaten is alleen vereist voor iOS-apps die zijn ondertekend met een ontwikkelaar of ad-hocprofiel.

Vereiste voorwaarden

Voordat u de apparaatmogelijkheden van App Center kunt gebruiken, moet u het volgende doen:

1. Laat het productiecertificaat worden gebruikt voor de oorspronkelijke app-ondertekening.
2. Zorg ervoor dat u de inloggegevens hebt voor uw Apple-ontwikkelaarsaccount met de rol van accounthouder, beheerder of app-manager.
3. Gebruik ondertekening handmatig beheren in plaats van automatisch ondertekening te beheren bij het distribueren van de app vanuit Xcode.

Apparaatregistratie

Als u een apparaat registreert, maakt u het onderdeel uit van de lijst met apparaten in de Apple Developer-portal die vervolgens kan worden opgenomen in een inrichtingsprofiel. Als u een apparaat wilt registreren, selecteert u een distributiegroep met ten minste één apparaat dat nog niet is ingericht en gaat u naar het tabblad Apparaten . U ziet hier een apparaat met de status Niet-inrichting en een bericht bovenaan met de mededeling dat er niet-ingerichte apparaten zijn. Volg deze stappen om de apparaten te registreren:

1. Selecteer de knop Apparaten registreren .
2. In een dialoogvenster wordt gevraagd om uw gebruikersnaam en wachtwoord die worden gebruikt in de Apple Developer-portal.
3. Nadat u zich hebt aangemeld met uw Apple-gebruikersnaam en -wachtwoord, worden de niet-geconfigureerde apparaten toegevoegd aan zowel uw Apple-ontwikkelaarsaccount als het provisioning-profiel voor releases.
4. U kunt eventueel een .p12-bestand uploaden om de app opnieuw te ondertekenen en te distribueren naar de zojuist toegevoegde apparaten. Lees meer over het genereren van een .p12-bestand.

Als u uw app liever afzonderlijk opnieuw bouwt met het bijgewerkte inrichtingsprofiel, kunt u App Center nog steeds gebruiken om de apparaten van uw tester automatisch te registreren in de Apple-ontwikkelaarsportal zonder de stap voor opnieuw ondertekenen. Hiervoor laat u mijn app opnieuw ondertekenen uitgeschakeld en downloadt u het bijgewerkte inrichtingsprofiel met de knop op het controlescherm. U kunt het inrichtingsprofiel ook downloaden via Xcode of de Apple Developer-portal.

Een nieuwe release distribueren

Wanneer u een nieuwe release distribueert naar een groep waarvoor automatisch apparaatbeheer niet is ingeschakeld, maakt een stap Apparaten deel uit van de wizard. De stap controleert of u niet geconfigureerde apparaten in de distributiegroep hebt; indien dit het geval is, kunt u het selectievakje Apparaten registreren en app opnieuw tekenen aanvinken. App Center voert vervolgens drie bewerkingen voor u uit:

1. Registreer nieuwe apparaat-id's in de Apple Developer-portal.
2. Voeg de apparaten toe aan het inrichtingsprofiel en download het.
3. Onderteken het geüploade binaire bestand opnieuw, zodat alle testers het kunnen installeren.

De flow vereist de gebruikersnaam en het wachtwoord voor de Apple Developer-portal en het certificaat dat wordt gebruikt om de app tijdens de build te ondertekenen. U geeft het certificaat op als een geëxporteerd .p12-bestand. Lees meer over het genereren van een .p12-bestand. Als u uw Apple ID en certificaat al hebt opgeslagen in App Center, kunt u deze kiezen in de vervolgkeuzelijsten.

Privacyproblemen met betrekking tot gebruikersnaam en wachtwoord

Wanneer u uw Apple-referenties en een handtekeningcertificaat toevoegt aan App Center, gebruiken we een beveiligde verbinding. In App Center worden de gegevens opgeslagen in een versleutelde kluis. Het is niet mogelijk voor een gebruiker om gevoelige informatie uit de kluis te downloaden of op te halen.

Als u deze set referenties en een certificaat opgeeft, is deze automatisch beschikbaar voor app-medewerkers, maar alleen voor die specifieke service. Stel dat ontwikkelaar X referenties en certificaten toevoegt aan distributiegroep 'Tester'. Wanneer ontwikkelaar Y vervolgens een nieuwe release distribueert naar de groep 'Tester', worden de gebruikersnaam, het wachtwoord en het certificaat van X standaard geselecteerd. App Center gebruikt deze voor ontwikkelaar Y. App Center gebruikt uw Apple ID alleen tijdens de transactie en gebruikt deze niet voor iets anders.

Limiet voor Apple-apparaatregistratie

Elk Apple-ontwikkelaarsaccount heeft een eindig aantal plekken voor apparaten per apparaattype. Apple werkt met vijf apparaattypen: iPad, iPhone, iPod, Apple TV en Apple Watch. Elk van deze heeft een beperking van 100 apparaten. Stel dat u zes apparaten registreert, die allemaal iPhones zijn. U hebt dan nog 94 apparaat-id's voor iPhones en nog steeds 100 over voor elk van de vier andere apparaattypen. nl-NL: U kunt apparaten slechts één keer per jaar uitschrijven om de slots terug te krijgen.

Een .p12-bestand genereren

U kunt een Apple-distributiecertificaat en een persoonlijke sleutel opslaan in een bestand met persoonlijke gegevensuitwisseling (.p12). Hiervoor hebt u een Apple-productiecertificaat nodig dat is opgeslagen op uw lokale computer. Als u dat niet doet, hebt u de persoonlijke sleutel niet.

1. Open de app Sleutelhangertoegang op uw Mac en selecteer de categorie Mijn certificaten aan de linkerkant.
2. Zoek het juiste distributiecertificaat en vouw het uit om de bijbehorende persoonlijke sleutel weer te geven. een. Als de persoonlijke sleutel er niet is, moet u een nieuw certificaat maken of deze stappen uitvoeren op de computer waarop u het certificaat hebt gemaakt.
3. Selecteer het certificaat of de persoonlijke sleutel of beide. Klik vervolgens met de rechtermuisknop op de geselecteerde items om het contextmenu op te halen en selecteer de actie die begint met Exporteren.
4. Selecteer een locatie op schijf om het bestand op te slaan als .p12. Kies een sterk wachtwoord voor het bestand.

Certificaten en Apple-id's verwijderen uit App Center

U kunt de certificaten en Apple-id's verwijderen uit App Center in de ontwikkelaarsaccounts.

1. Selecteer Accountinstellingen onder uw profielfoto in de rechterbovenhoek.
2. Selecteer Ontwikkelaarsaccounts.
3. Verwijder het geheim met behulp van de drie verticale puntjes aan de rechterkant van de tabel en verwijder het certificaat.
4. Controleer de naam van het certificaat en bevestig de ongedaanbare actie door nogmaals Verwijderen te selecteren.

Lees meer over het beheren van uw Apple ID en certificaten.

Apparaten handmatig registreren bij Apple

Als u rechtstreeks probeert te distribueren naar gebruikers buiten App Center, kunt u de stappen volgen op de website van Apple Developer over het distribueren naar geregistreerde apparaten. In de stappen wordt beschreven hoe u handmatig apparaten aan uw account toevoegt en uw app opnieuw ondertekent.

Bekende fouten

Kan het profiel niet vinden

Wanneer u zich aanmeldt bij Apple via App Center, controleren we de inrichtingsprofiel(s) die zijn opgenomen in uw toepassing op basis van die in uw ontwikkelaarsaccount. Als een profiel dat wordt gebruikt in een binair bestand niet wordt gevonden in uw Apple-ontwikkelaarsaccount, kan App Center uw toepassing niet opnieuw ondertekenen. U kunt dit oplossen door ervoor te zorgen dat uw Apple-ontwikkelaarsaccount alle inrichtingsprofielen bevat die in uw toepassing worden gebruikt. U kunt toepassingsprofielen controleren op het tabblad Algemeen van de eigenschappen van uw Xcode-project of de opties voor ondertekening van iOS-bundels in Visual Studio voor Mac.

Team is niet gevonden

Wanneer u zich aanmeldt bij Apple door middel van App Center, worden de teams in uw applicaties vergeleken met die in uw ontwikkelaarsaccount. Als een team dat in het binaire bestand wordt gebruikt, niet wordt gevonden in uw Apple-ontwikkelaarsaccount, kan App Center uw toepassing niet opnieuw ondertekenen. U kunt dit oplossen door ervoor te zorgen dat uw Apple-ontwikkelaarsaccount het team bevat dat in uw toepassing wordt gebruikt. U kunt het toepassingsteam controleren op het tabblad Algemeen van de eigenschappen van uw Xcode-project of de opties voor ondertekening van iOS-bundels in Visual Studio voor Mac.

Bijgewerkte gebruiksrechtovereenkomst

Apple werkt de gebruiksrechtovereenkomst regelmatig bij. Als u de Apple Developer-portal wilt blijven gebruiken, moet u de bijgewerkte licentie lezen en ermee akkoord gaan.

1. Meld u aan bij de Apple Developer-portal.
2. Volg de instructies voor het accepteren van de gebruiksrechtovereenkomst.

App Center kan niet helpen met de inhoud in de licentie of het proces voor de licentieovereenkomst.

Onze tester heeft hun apparaat-id niet geregistreerd

Als een tester per ongeluk heeft geselecteerd dat ik deze al heb geregistreerd, voert u de volgende stappen uit om een apparaat handmatig te registreren:

1. Ga naar https://install.appcenter.ms/register-device op uw mobiele apparaat.
2. Selecteer Registreren en volg de instructies op het scherm.