Publisere iOS-oppdatering: trinnvis utrulling

For å publisere en iOS-oppdatering oppretter du en ny versjon i App Store Connect, med et høyere nummer. Du legger ved et nytt build, skriver «What's New»-teksten og sender den til App Review. Hver nye versjon går gjennom Apples gjennomgang på nytt, selv for en enkel feilretting. Før du sender den, velger du hvordan den skal slippes etter godkjenning: manuelt, med en gang, ikke før en bestemt dato, eller med trinnvis utrulling over 7 dager.

Trinnvis utrulling gjelder bare automatiske oppdateringer: 1 % av disse brukerne første dag, alle på den sjuende. Du kan pause den i opptil 30 dager totalt, eller fullføre den på én gang. Denne guiden følger Apples hjelpesider, gjennomgått 3. november 2026.

Jeg publiserer oppdateringer av iOS-appene mine med Expo og EAS, blant annet Solys, TradaZen og Nolera. Eksemplene lenger ned kommer fra disse utgivelsene.

Publisere en iOS-oppdatering: stegene i rekkefølge

App Store Connect-hjelpen om nye versjoner beskriver denne gangen:

1. Under Apps velger du appen din, og klikker på +-knappen ved siden av plattformen.
2. Skriv inn et versjonsnummer som er høyere enn det forrige, og klikk på Create.
3. Les gjennom metadataene: de fra den publiserte versjonen kopieres automatisk.
4. Last opp et nytt build, med et økt buildnummer.
5. Test buildet i TestFlight, legg det til versjonen og send den til App Review.

To krav før du begynner. Den publiserte versjonen må ha statusen Ready for Distribution. Og du må ha en av disse rollene: Account Holder, Admin, App Manager eller Marketing.

Det finnes ingen vei tilbake. Apple skriver det på samme side: hvis en versjon skaper problemer, kan du ikke gå tilbake til den forrige. Du må opprette og sende inn en ny versjon.

Versjonsnummer og buildnummer

Versjonen er nummeret kundene dine ser på produktsiden. Buildet identifiserer hver opplasting. Kombinasjonen av versjon og build må være unik: reglene og feilene som hører til, finner du i versjon og buildnummer.

Min konvensjon, som ikke er en regel fra Apple: siste siffer går opp ved en feilretting, fra 1.4.0 til 1.4.1. Det midterste går opp ved en ny funksjon, fra 1.4.1 til 1.5.0. Buildnummeret går bare oppover, fra den ene versjonen til den neste. Med Expo ligger versjonen i app.json, og EAS kan øke buildnummeret ved hvert produksjonsbygg. Oppsettet finner du i publisere en Expo-app med EAS.

«What's New»-teksten: hva Apple krever

Siden om versjonsinformasjon beskriver feltet What's New in This Version:

• Maks 4 000 tegn.
• Finnes ikke for første versjon, påkrevd for alle de neste.
• Kan oversettes til hvert språk på produktsiden din.

Regel 2.3.12 i App Review Guidelines legger til et krav: nye funksjoner og endringer i produktet skal beskrives tydelig. En generell formulering holder for enkle rettinger av feil, sikkerhet eller ytelse. En viktig endring må listes opp. «Feilrettinger og forbedringer» holder altså ikke for en versjon som endrer abonnementet ditt eller hovedskjermen.

Apple anbefaler også, på siden sin om vurderinger, at du nevner i notatene problemer som er rettet og som kunder hadde beskrevet i vurderingene sine.

Her er tre maler du kan tilpasse, én per type versjon.

For en feilretting:

Rettinger og stabilitet.
- [Funksjon]: [det som ikke virket] er rettet.
- [Skjerm] laster raskere.
Takk til dere som meldte fra.

For en ny funksjon:

Nytt: [funksjonen, med fem ord].
[Hva du kan gjøre nå, i én setning.]
Hvor du finner den: [fane] > [knapp].

Også i denne versjonen:
- [Synlig forbedring].
- Feilrettinger.

For en flyt som endres:

[Skjerm eller flyt] endres.
- Hva som endres for deg: [konkret effekt].
- Hva du beholder: [data, innstillinger, kjøp].
Spørsmål? [Innstillinger] > [Hjelp].

Siste linje i feilrettingsmalen gjelder bare hvis noen faktisk har meldt fra om problemet. Skriv aldri om en nyhet som ikke er i buildet: regel 2.3 krever metadata som stemmer med appen.

Manuell, automatisk eller datostyrt utgivelse

Hjelpen om utgivelsesvalg gir tre valg:

Valg	Etter Apples godkjenning
Manuell	Status Pending Developer Release, du publiserer når du vil
Automatisk	Versjonen slippes med en gang den er godkjent
Automatisk, ikke før ...	Den venter til valgt dato, og slippes så av seg selv

Ved manuell utgivelse åpner du versjonen med statusen Pending Developer Release, klikker på Release This Version og bekrefter. Apple advarer om at det kan ta opptil 24 timer før den dukker opp i App Store. En melding på versjonssiden gir deg Cancel This Release for å avbryte. Hvis versjonen venter i mer enn 30 dager, sender Apple deg en påminnelse på e-post.

Manuell utgivelse lar deg velge tidspunktet, for eksempel for å publisere samme dag som en kunngjøring. Solys 2.0.0, som hadde en ny versjon av årsabonnementet, gikk til gjennomgang i slutten av september 2026 med manuell utgivelse.

For en rutineversjon lar jeg den stå på automatisk. Nolera 1.0.2, godkjent 12. oktober 2026, dukket opp i App Store mindre enn ett minutt etter e-posten fra Apple, ifølge iTunes' offentlige søke-API. Det er én enkelt observasjon: beregn god margin.

Trinnvis utrulling over 7 dager

Apples hjelp om trinnvis utrulling gir den nøyaktige timeplanen:

Dag	Andel av brukerne
1	1 %
2	2 %
3	5 %
4	10 %
5	20 %
6	50 %
7	100 %

Oppdateringen går til et tilfeldig utvalg av brukerne som har slått på automatiske oppdateringer, på kompatible enheter. De får ikke beskjed om at de er med.

Trinnvis utrulling bremser bare automatiske oppdateringer. Apple presiserer at hvem som helst kan laste ned den nye versjonen fra App Store, når som helst. En som installerer appen din, eller trykker på «Update» på produktsiden, kan altså få den fra første dag. Det er ikke en test på 1 % av brukerne dine: det er en brems på de andre.

For å slå den på åpner du versjonen, blar ned til seksjonen Phased Release for Automatic Updates, huker av «Release update over a 7-day period using phased release» og lagrer. Du trenger rollen Account Holder, Admin eller App Manager. Valget er tilgjengelig helt til statusen Pending Developer Release: du kan fortsatt slå det på etter Apples godkjenning, så lenge versjonen venter på at du slipper den manuelt.

Når versjonen er godkjent, får statusen Ready for Distribution merket «Phased Release». Når de 7 dagene er over, får appens Admin og App Manager et varsel.

Pause, gjenopptak og utgivelse til alle

• Pause: opptil 30 dager totalt, fordelt på så mange ganger du vil. En pause på 10 dager gir 20 dager igjen til de neste.
• Gjenopptak: utrullingen fortsetter fra dagen der du stoppet den.
• Utgivelse til alle: knappen Release to All Users, øverst til høyre på versjonen, sender oppdateringen til alle enheter med automatisk oppdatering.
• Fjerning fra salg: stopper utrullingen for godt, også hvis medlemskapet ditt i utviklerprogrammet går ut. Hvis appen kommer tilbake i salg, blir versjonen tilgjengelig for alle på én gang.

Etter utgivelse til alle kan ingenting lenger justeres, presiserer tabellen over redigerbare egenskaper.

Nolera 1.0.2 ble sluppet uten trinnvis utrulling. Slik ville jeg brukt den i løpet av uken:

Hva du ser	Hva du gjør	Hva som skjer
Krasj eller bekymrede vurderinger	Pause	De automatiske oppdateringene stopper
Feilrettingen er klar	Ny versjon	Den går til gjennomgang igjen, med egen utrulling
Ingenting unormalt etter 3 eller 4 dager	Release to All Users	Alle får den
Du venter på svar fra Apple	Pause, 30 dager totalt	Fortsetter fra dagen der du stoppet

Under en pause fortsetter de manuelle nedlastingene. Huk av trinnvis utrulling for alle versjoner som berører betaling eller første oppstart: det er der en feil koster mest, og du kan ikke gå tilbake.

Når feilrettingen haster: fremskyndet gjennomgang

Apple lar deg be om en fremskyndet gjennomgang. Den er forbeholdt ekte nødstilfeller: en kritisk feil som må rettes, eller en utgivelse knyttet til en hendelse.

1. Send inn versjonen din først. Beskriv feilen i Notes-feltet til den som gjennomgår.
2. Fyll ut skjemaet for fremskyndet gjennomgang, og velg appen og plattformen.
3. Apple fremskynder gjennomgangen etter kapasitet. Ingenting er garantert.

For en hendelse oppgir du i notatene datoen og din tilknytning til den. De vanlige ventetidene finner du i ventetiden for godkjenning i App Store.

Hva som går til gjennomgang igjen, og hva som ikke gjør det

Endring	Hva som trengs
Native kode, tillatelser, SDK-versjon	Nytt build, ny versjon, full gjennomgang
Skjermbilder, beskrivelse, nøkkelord, nyheter	En ny versjon, gjennomgått sammen med den
Promoteringstekst	Ingenting: den endres uten ny innsending
Pause, gjenopptak, utgivelse til alle	Ingenting: det er utgivelsesinnstillinger
Toppbilde på produktsiden i iOS 27	Alene i Asset Library, eller med en versjon
JavaScript-retting, med Expo	En fjernoppdatering er mulig

Promoteringsteksten endres uten ny innsending, ifølge siden om versjonsinformasjon. Med Expo endrer en fjernoppdatering JavaScript, tekster og bilder uten å gå via App Store. Expo-dokumentasjonen setter to grenser: native kode, tillatelser og SDK-versjon krever en ny binærfil, og oppdateringene må følge App Store-reglene.

Mitt tilfelle: en fjernretting som den som gjennomgikk aldri så

I september 2026 ventet et build av Nolera på gjennomgang. Jeg hadde rettet en feil på skanneskjermen, og publisert rettingen som fjernoppdatering mens jeg ventet. Buildet ble likevel avvist, for denne allerede rettede feilen.

Forklaringen står i dokumentasjonen for expo-updates: som standard laster appen ned oppdateringen ved oppstart og tar den i bruk ved neste oppstart. Den som gjennomgår installerer appen, starter den én gang og tester koden som ligger i buildet. Den samme regelen gjelder for nye brukere: den første økten deres kjører på koden i buildet.

Siden da går alle endringer av startskjermen, betalingsmuren eller hovedfunksjonen i et nytt build. Fjernoppdateringen er bare for dem som allerede har appen.

Nullstille vurderingen med en versjon

Hver nye versjon har valget Reset rating when this version is released. Ifølge Apples hjelp om nullstilling gjelder det alle land, beholder de skrevne vurderingene og kan ikke angres etter utgivelse. Apple anbefaler å bruke det sparsomt, fordi en produktside med få vurderinger kan virke avskrekkende.

Sjekklisten før du sender inn oppdateringen

• Versjonsnummeret er høyere, buildnummeret er økt.
• Buildet er testet i TestFlight, på en liten iPhone og på iPad hvis appen kjører der.
• Nyhetene er skrevet på hvert språk, og viktige endringer er listet opp.
• Skjermbildene viser dagens grensesnitt hvis det er endret.
• Notatene til den som gjennomgår sier hva som er endret og hvor det finnes.
• Utgivelsesvalget er satt: manuell hvis du må holde en dato.
• Trinnvis utrulling er huket av hvis versjonen berører betaling eller første oppstart.
• Du vet om en eventuell retting kan sendes som fjernoppdatering, eller om den krever et build.

Komme gjennom gjennomgangen ved hver oppdatering

Hver oppdatering går gjennom App Review igjen, og en avvisning blokkerer rettingen din. Review Kit samler sjekklisten min før innsending, avvisningene jeg har løst og to Claude Code-skills som går gjennom prosjektet og produktsiden din, og forbereder svaret ditt hvis Apple avviser. Hele gangen finner du på siden publisere en app i App Store.

Hvis du forbereder din første utgivelse, ta den gratis diagnosen: den setter stegene i riktig rekkefølge og sender deg sjekklisten min mot avvisning fra Apple.

Ofte stilte spørsmål

Hvor lenge varer trinnvis utrulling i App Store?

Sju dager: 1 % av brukerne med automatisk oppdatering første dag, så 2, 5, 10, 20 og 50 %, og 100 % den sjuende. Du kan pause den i opptil 30 dager totalt, eller fullføre den når som helst med Release to All Users.

Går en oppdatering av en iOS-app gjennom Apples gjennomgang igjen?

Ja. Hver nye versjon, med build og metadata, går gjennom App Review. Promoteringsteksten og utgivelsesinnstillingene kan derimot endres uten ny innsending.

Kan man gå tilbake til en eldre versjon av en app i App Store?

Nei. Du må opprette en ny versjon med rettingen og sende den til gjennomgang. Det er derfor trinnvis utrulling og pausen er nyttige.

Får nye brukere oppdateringen under trinnvis utrulling?

Ja, hvis de laster ned appen fra App Store. Trinnvis utrulling styrer bare automatiske oppdateringer: hvem som helst kan laste ned den nye versjonen når som helst.

Kan man slå på trinnvis utrulling etter at Apple har godkjent?

Ja, så lenge versjonen har statusen Pending Developer Release, altså manuell utgivelse som ennå ikke er publisert. Når versjonen er sluppet, er det for sent for den versjonen.

Hva skal stå i versjonsnotatene for en oppdatering?

Nye funksjoner og viktige endringer, tydelig listet opp: det er regel 2.3.12. For en enkel retting av feil, sikkerhet eller ytelse holder en generell formulering. Feltet tar 4 000 tegn og kan oversettes til hvert språk.