Flutter App IOS Build

IOS Build:

Uygulamanz oluturmak ve yaynlamak iin Xcode gereklidir. Bu klavuzu takip etmek iin macOS altran bir cihaz kullanmalsnz.

Admlar:
1.) BundleId oluturma (Gelitirici hesabndan)
2.) Uygulamay App Store Connect'de kaydetmek.
3.) Xcode ya da Codemagic CLI ' kullanarak build arivi oluturma.
4.) Uygulamay App Store da yaynlama.

Uygulamanz App Store Connect'e kaydedin:
Uygulamanzn yaam dngsn App Store Connect'te (eski adyla iTunes Connect) ynetin. App Store ve TestFlight'ta uygulama adnz ve aklamanz tanmlar, ekran grntleri ekler, fiyatlandrmay ayarlar ve srmleri ynetirsiniz.

Uygulama kaydetmek iki admdan oluur:
1.) Benzersiz(unique) bir Bundle ID kaydetme.
2.) App Store Connect'te bir uygulama kayd oluturma.

Bir Bundle ID Kaydedin:

Her iOS uygulamas, Apple'a kaytl benzersiz bir tanmlayc olan Bundle ID ile ilikilendirilir.

Gelitirici hesabnzn App IDs sayfasn an.
Yeni bir Bundle ID oluturmak iin + esine tklayn.
Bir uygulama ad girin, Explicit App ID'yi sein ve bir ID girin.
Uygulamanzn kulland hizmetleri sein ve ardndan Continue'a tklayn.
Sonraki sayfada, ayrntlar onaylayn ve Bundle ID'nizi kaydetmek iin Register'a tklayn.

Bir Uygulamay App Store Connect'e kaydetmek iin:

Taraycnzda App Store Connect'i an.
App Store Connect al sayfasnda My Apps'e tklayn.
My Apps sayfasnn sol st kesindeki + butonuna tklayn, ardndan New App'i sein.
Alan forma uygulamanzn ayrntlarn girin. Platforms blmnde iOS'un iaretli olduundan emin olun. Flutter u anda tvOS'u desteklemediinden, bu onay kutusunu iaretlemeden brakn. Create'e tklayn.
Uygulamanzn application details alanna gidin ve sidebar'dan App Information'n sein.
General Information blmnde, nceki admda kaydettiiniz Bundle ID'yi sein.

Xcode proje ayarlarnz gzden geirin:

Bu adm, Xcode alma alanndaki(workspace) en nemli ayarlarn gzden geirilmesini kapsar.

Xcode'da targets settings'e gidin:
Xcode'da, uygulamanzn ios klasrnde Runner.xcworkspace'i an.
Uygulama ayarlarnz grntlemek iin Xcode proje gezgininde Runner projesini sein. Ardndan, sidebar'da Runner alann sein. General sekmesini sein.

En nemli ayarlar dorulayn:

Identity blmnde:

Display Name : Uygulamanzn grnen ad.

Bundle Identifier : App Store Connect'te kaydettiiniz App ID.

Signing & Capabilities blmnde:

Automatically manage signing: Xcode'un uygulama imzalama ve salamay otomatik olarak ynetmesi gerekip gerekmedii. Bu, varsaylan olarak true'dur ve ou uygulama iin yeterli olacaktr.

Team: Kaytl Apple Developer hesabnzla ilikili ekibi sein. Gerekirse, Add Account, esini sein, ardndan bu ayar gncelleyin.

Build Settings blmnde:

iOS Deployment Target : Uygulamanzn destekledii minimum iOS srm. Flutter, iOS 9.0 ve sonraki srmleri destekler. Uygulamanz veya eklentileriniz, iOS 9'dan daha yeni API'leri kullanan Objective-C veya Swift kodu ieriyorsa, bu ayar gereken en yksek srme gncelleyin.

Uygulama datm srmn gncelleme:

Xcode projenizde Deployment Target alann deitirdiyseniz, Flutter uygulamanzda ios/Flutter/AppframeworkInfo.plist'i an ve MinimumOSVersion deerini eleecek ekilde gncelleyin.

Uygulama srm numarasn gncelleme:

Uygulamann varsaylan srm numaras 1.0.0'dr. Gncellemek iin pubspec.yaml dosyasna gidin ve aadaki satr gncelleyin:

version: 1.0.0+1

Srm numaras, yukardaki rnekte 1.0.0 gibi noktalarla ayrlm saydr ve ardndan yukardaki rnekte 1 gibi istee bal bir build number gelir ve + ile ayrlr.

Flutter'n derlemesinde hem version hem de build number, srasyla --build-name ve --build-number belirtilerek geersiz klnabilir.

iOS'ta build-name CFBundleShortVersionString'i, build-number CFBundleVersion' kullanr.

Bir app icon ekleyin:
Xcode project navigator'da Runner klasrnde Assets.xcassets esini sein. Placeholder iconlarn kendi uygulama simgelerinizle gncelleyin.

Uygulamanz flutter run kullanarak altrn ve simgenin deitirildiini dorulayn.

Xcode ile bir build arivi oluturun

Uygulamanz App Store veya TestFlight'taki kullanclara gndermeye hazr olduunuzda, bir release build (srm derlemesi) hazrlamanz gerekir.

Xcode'da uygulama srmn yaplandrn ve unu oluturun:

1. Xcode'da, uygulamanzn ios klasrnde Runner.xcworkspace'i an.

2. Xcode proje gezgininde Runner' sein, ardndan ayarlar grnm kenar ubuunda Runner hedefini sein.

3. Identity blmnde, Version'u, yaynlamak istediiniz kullancya ynelik version numarasna gncelleyin.

4. Identity blmnde, Build identifier' App Store Connect'te bu build'i izlemek iin kullanlan unique bir build number'la gncelleyin. Her ykleme benzersiz bir build number gerektirir.

Son olarak, bir build archive oluturun ve bunu App Store Connect'e ykleyin:

1.Bir build archive oluturmak iin flutter build ipa 'y altrn.

1. Xcode'da build/ios/archive/MyApp.xcarchive dosyasn an.

3.Validate App button'una tklayn. Herhangi bir sorun bildirilirse, bunlar ele aln ve baka bir build oluturun. Bir ariv ykleyene kadar ayn build ID'i yeniden kullanabilirsiniz.

1. Ariv baaryla dorulandktan sonra, Distribute App'e tklayn. Derlemenizin durumunu, uygulamanzn App Store Connect'teki apps details sayfasnn Activities sekmesinden takip edebilirsiniz.

Not: Uygulamanz Distribute App'in sonunda da aktardnzda, Xcode uygulamanzn IPA'sn ve bir ExportOptions.plist dosyasn ieren bir dizin oluturur.

Flutter build ipa --export-options-plist=path/to/ExportOptions.plist 'i altrarak Xcode'u balatmadan ayn seeneklerle yeni IPA'lar oluturabilirsiniz.

30 dakika iinde, build'inizin dorulandn ve TestFlight'ta test kullanclarna sunulmaya hazr olduunu bildiren bir e-posta alacaksnz. Bu noktada, TestFlight'ta yaynlamay veya devam edip uygulamanz App Store'da yaynlamay seebilirsiniz.

Codemagic CLI aralaryla build ariv oluturmak iin:

Bu adm, bir build ariv oluturmay ve Flutter proje dizinindeki bir terminalde yrtlen Flutter derleme komutlarn ve Codemagic CLI Aralarn kullanarak derlemenizi App Store Connect'e yklemeyi kapsar. Bu, login keychain'den izole edilmi geici bir keychain'le datm sertifikalarnn (distribution certificates) tam denetimine sahip bir build arivi oluturmanza olanak tanr.

1. Codemagic CLI aralarn kurun:
   pip3 install codemagic-cli-tools

2. App Store Connect ile ilemleri otomatikletirmek iin App Manager eriimi olan bir App Store Connect API Key oluturmanz gerekir. Sonraki komutlar daha ksa hale getirmek iin new key'den u ortam deikenlerini ayarlayn: issuer id, key id, and API key file.
   

export APP_STORE_CONNECT_ISSUER_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeeeexport APP_STORE_CONNECT_KEY_IDENTIFIER=ABC1234567export APP_STORE_CONNECT_PRIVATE_KEY=`cat /path/to/api/key/AuthKey_XXXYYYZZZ.p8`

1. Bir build arivini kodlamak ve paketlemek iin bir iOS Distribution sertifikasn export etmeniz veya oluturmanz gerekir.

Mevcut sertifikalarnz varsa, her sertifika iin aadaki komutu yrterek private key'i export edebilirsiniz:

openssl pkcs12 -in <certificate_name>.p12 -nodes -nocerts | openssl rsa -out cert_key

Veya aadaki komutu uygulayarak yeni bir private key oluturabilirsiniz:

ssh-keygen -t rsa -b 2048 -m PEM -f cert_key -q -N ""

Daha sonra, CLI aralarnn private keyden otomatik olarak yeni bir iOS Datm oluturmasn salayabilirsiniz.

1. Kod imzalama iin kullanlacak yeni bir geici keychain ayarlayn:keychain initialize

daha sonra bunu altrn:
keychain use-login

Bu, makinenizdeki uygulamalarla ilgili olas kimlik dorulama sorunlarn nlemek iin login keychain'inizi (oturum ama anahtar zincirinizi) varsaylan olarak ayarlar.

5. App Store Connect'ten kod imzalama dosyalarn aln:

app-store-connect fetch-signing-files $(xcode-project detect-bundle-id) \    --platform IOS \    --type IOS_APP_STORE \    --certificate-key=@file:/path/to/cert_key \    --create

Burada cert_key, export edilen iOS Distribution certificate private key veya otomatik olarak yeni bir sertifika oluturan yeni bir private keydir.Sertifika, App Store Connect'te yoksa zel anahtardan oluturulacaktr.

1. Alnan sertifikalar keychain'ize ekleyin:
   
   keychain add-certificates

2. Getirilen kod imzalama profillerini kullanmak iin Xcode proje ayarlarn gncelleyin:
   xcode-project use-profiles

3. Flutter bamllklarn ykleyin:
   flutter packages pub get

9.CocoaPods bamllklarn ykleyin:

find . -name "Podfile" -execdir pod install \;

1. Flutter' iOS projesini oluturun:

flutter build ipa --release \    --export-options-plist=$HOME/export_options.plist

export_options.plist esinin xcode-project use-profiles komutunun kts olduunu unutmayn.

11.Uygulamay App Store Connect'te yaynlayn:

app-store-connect publish \    --path $(find $(pwd) -name "*.ipa")

1. Daha nce de belirtildii gibi, makinenizdeki uygulamalarla ilgili kimlik dorulama sorunlarn nlemek iin login keychain'inizi (oturum ama anahtar zincirinizi) default olarak ayarlamay unutmayn:keychain use-login

30 dakika iinde, yapnzn dorulandn ve TestFlight'ta test kullanclarna sunulmaya hazr olduunu bildiren bir e-posta alacaksnz. Bu noktada, TestFlight'ta yaynlamay veya devam edip uygulamanz App Store'da yaynlamay seebilirsiniz.

Uygulamanz TestFlight'ta yaynlayn:

TestFlight, gelitiricilerin uygulamalarn dahili ve harici test cihazlarna aktarmalarna olanak tanr. Bu istee bal adm, derlemenizi TestFlight'ta yaynlamay kapsar.

1. App Store Connect'te uygulamanzn application details sayfasnn TestFlight sekmesine gidin.

2. Sidebar'dan Internal Testing i sein.

3. Test kullanclarna yaymlanacak derlemeyi(buildi) sein ve ardndan Save'e tklayn.

4. Herhangi bir dahili test kullancsnn e-posta adreslerini ekleyin. Sayfann st ksmndaki alr menden eriilebilen App Store Connect'in Users and Roles sayfasnda ek dahili kullanclar ekleyebilirsiniz.

Uygulamanz App Store'da yaynlayn:

1. App Store Connect'te uygulamanzn application details sayfasnn sidebar'ndan Pricing and Availability'i sein ve gerekli bilgileri tamamlayn.

2. Sidebar'dan status' sein. Bu, bu uygulamann ilk srmyse, status 1.0 Prepare for Submission (Gnderime Hazrla)'dr. Tm gerekli alanlar doldurun.

3. Submit for Review'e tklayn.

Apple, uygulama inceleme sreci tamamlandnda sizi bilgilendirir. Uygulamanz, Version Release blmnde belirttiiniz talimatlara gre yaynlanr.

resource