Byg iOS-apps med Unity på Windows

Fra Windows til iPhone: Din Guide til Unity iOS Builds

At udvikle iOS-apps med Unity på et Windows-operativsystem kan virke som en udfordring, især når Apple traditionelt favoriserer macOS for sin udviklingssuite. Men med de rette værktøjer og en smule vejledning er det absolut muligt at bringe dine Unity-projekter fra Windows til iPhones og iPads. Denne guide vil dykke ned i den mest effektive metode: brugen af Unity Cloud Build i kombination med GitHub til at overkomme platformsbegrænsninger og strømline din build-proces.

Mens nogle metoder involverer virtuelle maskiner eller komplekse scripting-opsætninger, tilbyder Unity Cloud Build en integreret og cloud-baseret løsning, der lader dig kompilere dine projekter uden behov for en Mac. Følg disse trin omhyggeligt for at realisere dine iOS-udviklingsdrømme på Windows.

Trin 1: Forberedelse af dit Unity ID og GitHub Konto

Før vi kan begynde at bygge, skal du sikre dig, at du har de nødvendige konti sat op:

• Unity ID: Dette er din nøgle til Unitys økosystem, herunder Unity Cloud Build. Hvis du endnu ikke har en, kan du oprette en gratis konto via Unitys hjemmeside. Sørg for at logge ind på din Unity ID i Unity Hub. Du finder log ind-muligheden øverst til højre i Unity Hub ved at klikke på avatar-ikonet.
• GitHub Konto: Unity Cloud Build integrerer sig med versionsstyringssystemer som GitHub. Du skal oprette en konto på GitHub.com, hvis du ikke allerede har en. Download og installer derefter GitHub Desktop-applikationen på din Windows-computer og log ind med din nye konto.

Trin 2: Oprettelse af Apple Certifikater og Identifikatorer

Dette er det mest kritiske trin, da det involverer interaktion med Apples udviklerportal. Bemærk, at du skal have en Apple Developer Account eller være en del af et team med en sådan konto for at kunne udføre disse trin.

Forudsætninger:

• Git til Windows: Download og installer Git til Windows fra gitforwindows.org. Følg standard installationsindstillingerne. Efter installationen skal du have adgang til Git Bash, et kommandolinjeværktøj.
• Apple Developer Account: Nødvendigt for at oprette certifikater og App IDs.

Oprettelse af Certifikater:

1. Opret en ny mappe på din computer, kald den f.eks. "Apple Certificates".
2. Højreklik inde i denne mappe, vælg "Git Bash Here" (eller "Show more options" -> "Git Bash Here" på Windows 11) for at åbne Git Bash direkte i mappen.
3. Generer en privat nøgle: Kør følgende kommando i Git Bash:

   openssl genrsa -out YourApp.key 2048

   Dette opretter en fil kaldet `YourApp.key` i din mappe.

4. Opret en Certificate Signing Request (CSR): Kør denne kommando, hvor du erstatter pladsholderne med dine egne oplysninger (din iCloud-email, dit navn og din regionskode):

   openssl req -new -key YourApp.key -out YourApp.certSigningRequest -subj "//[email protected], CN=Dit Navn, C=DK"

   Erstat `[email protected]` med din iCloud-email, `Dit Navn` med dit fulde navn, og `DK` med din landekode (f.eks. DK for Danmark). Dette opretter en fil kaldet `YourApp.certSigningRequest`.

5. Opret et Apple Development Certificate:
   • Gå til Apples Developer Console: Apple Developer Portal.
   • Naviger til sektionen "Certificates".
   • Klik på plus-ikonet (+) for at oprette et nyt certifikat.
   • Vælg "Apple Development" (dette dækker apps til iOS, macOS osv.) og klik "Continue".
   • Upload den `YourApp.certSigningRequest`-fil, du lige har oprettet.
   • Klik "Continue". Apple vil generere et certifikat.
   • Download det genererede certifikat (typisk kaldet `development.cer`). Flyt denne fil til din "Apple Certificates"-mappe.

Oprettelse af App ID:

1. I Apples Developer Console, gå til sektionen "Identifiers".
2. Klik på plus-ikonet (+) for at oprette en ny App ID.
3. Vælg "App IDs" som type og klik "Continue".
4. Angiv en Description (navnet på din app, f.eks. "MinFantastiskeApp").
5. Angiv et Bundle ID. Dette skal være unikt. Formatet er typisk `com.ditnavn.appnavn` (brug kun små bogstaver, f.eks. `com.eksempel.minfantastiskeapp`). Vælg dit App ID Prefix (dit Team ID).
6. Klik "Continue" og derefter "Register". Gem dit Bundle ID og Team ID, da du skal bruge dem senere.

Tilføjelse af din iPhone som Testenhed:

1. I Apples Developer Console, gå til sektionen "Devices".
2. Klik på plus-ikonet (+) for at tilføje en enhed.
3. Vælg "iOS, tvOS, watchOS" som platform.
4. Giv din enhed et navn (f.eks. "MiniPhone").
5. Du skal nu finde din enheds UDID (Unique Device Identifier). Den nemmeste måde er at besøge et websted som udid.tech fra din iPhone. Følg instruktionerne for at downloade og installere en profil, der viser din UDID. Sørg for at gemme denne UDID. Du kan slette profilen igen bagefter.
6. Indtast din enheds UDID i feltet på Apple Developer Console og klik "Continue" og "Register". Dette tillader din app at blive installeret på din enhed.

Oprettelse af Provisioning Profile:

1. I Apples Developer Console, gå til sektionen "Profiles".
2. Klik på plus-ikonet (+) for at oprette en ny profil.
3. Vælg "iOS App Development" som profiltype og klik "Continue".
4. Vælg den App ID, du oprettede tidligere, og klik "Continue".
5. Vælg dit Apple Development Certificate (det, du downloadede tidligere) og klik "Continue".
6. Vælg din registrerede mobile enhed (din iPhone), og klik "Continue".
7. Giv Provisioning Profile et navn (f.eks. "MitNavn Provisioning Profile") og klik "Generate".
8. Download den genererede fil (med filtypen `.mobileprovision`). Flyt denne fil til din "Apple Certificates"-mappe.

Oprettelse af `.p12` certifikat:

1. Åbn Git Bash i din "Apple Certificates"-mappe.
2. Konverter dit `.cer`-certifikat til PEM-format:

   openssl x509 -in development.cer -inform DER -out YourApp.pem -outform PEM

   Dette opretter en fil kaldet `YourApp.pem`.

3. Generer din `.p12`-fil. Du bliver bedt om at indtaste en adgangskode. Husk denne adgangskode!

   openssl pkcs12 -password pass:DIT_ADGANGSKODE -export -inkey YourApp.key -in YourApp.pem -out YourApp.p12

   Erstat `DIT_ADGANGSKODE` med den adgangskode, du ønsker at bruge.

Nu har du alle de nødvendige filer: `YourApp.key`, `YourApp.certSigningRequest`, `development.cer`, `YourApp.pem`, `YourApp.p12` og din `.mobileprovision`-fil.

Trin 3: Konfiguration af dit Unity Projekt

Åbn dit Unity-projekt i Unity Hub. Hvis du ikke har et, skal du oprette et nyt.

Build Settings:

1. Gå til File > Build Settings.
2. Vælg "iOS" som platform og klik "Switch Platform".
3. Klik på Player Settings. Dette åbner Project Settings-vinduet under "Player".
4. Naviger til sektionen "Other Settings" under "iOS".
5. Under "Identification":
   • Marker "Override Default Bundle Identifier" og indtast det Bundle ID, du oprettede i Apples Developer Console (f.eks. `com.eksempel.minfantastiskeapp`).
   • Under "Signing" skal du vælge dit Team ID fra dropdown-menuen (dette er dit Apple Developer Team ID).
   • Aktiver "Automatically Sign In".

Trin 4: Aktivering af Unity Cloud Build

Unity Cloud Build er tjenesten, der vil håndtere selve build-processen i skyen.

1. I Unity Hub eller direkte i Unity-editoren, klik på ikonet for Manage Services (en sky-lignende ikon).
2. Find "Cloud Build" og slå det til.
3. Et nyt vindue åbnes. Vælg din organisation og klik "Create Project ID". Sørg for, at "Cloud Build" er aktiveret.

Trin 5: Upload dit Unity Projekt til GitHub

For at Unity Cloud Build kan få adgang til dit projekt, skal det være hostet på en repository-tjeneste som GitHub.

1. Åbn din GitHub Desktop-applikation.
2. Klik på "Create a new repository".
3. Giv det et navn (f.eks. "MinUnityAppProjekt"), vælg en lokal placering, og sørg for, at "Add .gitignore" er sat til "Unity".
4. Klik "Create repository".
5. Klik "Publish repository". Sørg for, at "Keep this code private" er ikke markeret, hvis du ønsker, at Unity skal kunne tilgå det (eller konfigurer adgang separat).
6. Flyt nu hele din Unity-projektmappe ind i den netop oprettede GitHub-repository-mappe.
7. Tilbage i GitHub Desktop vil du se ændringer. I "Summary"-feltet kan du skrive en beskrivelse (f.eks. "Initial project upload"). Klik "Commit to main" og derefter "Push origin".

Trin 6: Konfiguration af Unity Cloud Build

Nu skal vi fortælle Unity Cloud Build, hvordan det skal bygge dit projekt.

1. Gå til Unity Cloud Build-portalen: Unity Cloud Build.
2. Klik på "DevOps" og derefter "Set up Cloud Build".
3. Vælg "GitHub" som din kilde og godkend Unitys adgang til din GitHub-konto.
4. Vælg den repository, du lige har oprettet, og klik "Next: TARGET SETUP".
5. I "Config"-panelet, klik "Set up New Target".
6. Vælg "iOS" som platform.
7. Project Subfolder: Angiv navnet på din Unity-projektmappe, hvis den ikke ligger direkte i roden af repositoryet.
8. Unity Version: Vælg den Unity-version, som dit projekt er bygget med.
9. Klik "Next: Credentials".
10. Her skal du indtaste dine Apple-oplysninger:
    • Bundle ID: Indtast det Bundle ID, du oprettede tidligere.
    • Provisioning Profile: Upload din `.mobileprovision`-fil.
    • P12 Certificate: Upload din `YourApp.p12`-fil.
    • P12 Password: Indtast den adgangskode, du valgte, da du oprettede `.p12`-filen.
11. Klik "Next: Build". Unity Cloud Build vil nu starte den første build af dit projekt. Dette kan tage et stykke tid afhængigt af projektets størrelse.

Validering af Signeringsoplysninger:

Efter den første build kan du kontrollere, om dine Apple-oplysninger er gyldige:

1. I Unity Cloud Build-dashboardet, gå til "Config" og derefter "Signing Credentials".
2. Hvis "Provisioning Profile" og "P12 File" begge er markeret som "VALID", er din opsætning korrekt.

Trin 7: Modtagelse og Installation af din Build

Når din build er succesfuld:

1. Unity Cloud Build sender dig en e-mail med et link til download af din app.
2. Åbn e-mailen på din iPhone og klik på download-linket.
3. Du bliver muligvis bedt om at logge ind på din Unity-konto igen.
4. Klik "Install". Du vil blive bedt om at installere en profil for at verificere din UDID. Gå til din iPhones Settings > General > VPN & Device Management, find "Unity Profile" (eller lignende) og installer den.
5. Gå tilbage til websiden og klik "Install" igen. Din app vil begynde at downloade og installere på din iPhone. Bemærk, at der ikke altid er en tydelig indikation på skærmen under downloaden.
6. Når appen dukker op på din startskærm, kan du åbne den og teste den!

Trin 8: Gentagelse af Builds og Opdateringer

Når du laver ændringer i dit Unity-projekt, skal du blot committe og pushe ændringerne til din GitHub-repository:

1. Åbn GitHub Desktop.
2. Skriv en beskrivelse af dine ændringer i "Summary"-feltet.
3. Klik "Commit to main" og "Push origin".

Unity Cloud Build vil automatisk registrere ændringerne og starte en ny build. Du modtager en e-mail, når den er færdig, eller du kan tjekke status i "Build History"-sektionen på Unity Cloud Build-dashboardet.

Ofte Stillede Spørgsmål (FAQ)

Er det muligt at bygge Unity3D-projekter på Windows?

Ja, absolut. Ved at bruge Unity Cloud Build kan du kompilere dine projekter i skyen uden behov for en Mac. Du kan også bruge versionsstyringssystemer som Git til at administrere dine projektfiler.

Hvordan kan jeg deploye en Unity-script til en tilsluttet iPhone fra Windows?

Den mest robuste metode, som beskrevet i denne guide, er at bruge Unity Cloud Build. Direkte deployment fra Unity Editor på Windows til en iPhone er kompliceret og kræver ofte virtuelle maskiner og specifikke værktøjer som `ios-deploy` og `xcodebuild`, hvilket kan være teknisk krævende.

Hvad hvis min build fejler?

Hvis din build fejler, vil Unity Cloud Build give dig fejlmeddelelser i "Build History". Gennemgå disse fejl omhyggeligt. Ofte skyldes fejlkonfiguration af certifikater, forældede provisioneringsprofiler eller problemer med projektets indstillinger i Unity.

Hvor stor bliver min `.ipa`-fil?

IPA-filer til iOS kan blive ret store. Nogle gange kan du reducere størrelsen ved at deaktivere bitcode i Xcode-projektet, hvis du har adgang til det, eller ved at optimere dine Unity-assets. Unity Cloud Build giver dig mulighed for at konfigurere specifikke build-indstillinger.

Kan jeg uploade min `.ipa`-fil til App Store fra Windows?

Selve uploaden til App Store Connect skal ske via Apples Application Loader eller direkte fra Xcode. Unity Cloud Build genererer `.ipa`-filen, som du derefter kan downloade og uploade manuelt via disse værktøjer, der kræver en Mac eller macOS på en virtuel maskine.

Ved at følge denne omfattende guide er du nu udstyret til at bygge og teste dine Unity iOS-apps direkte fra din Windows-computer. Unity Cloud Build er et kraftfuldt værktøj, der fjerner mange af de traditionelle hindringer for cross-platform udvikling.

Hvis du vil læse andre artikler, der ligner Byg iOS-apps med Unity på Windows, kan du besøge kategorien Software.