Apple Developer Onayı Geldikten Sonra — Step-by-Step Runbook

Bu doküman “Welcome to the Apple Developer Program” email’i geldiği andan itibaren izlenecek adımları sıralar. Hedef: email’den ~2 saat içinde TestFlight’ta çalışan build.

Toplam aktif iş süresi: ~45 dakika. Bekleme süresi (build + propagation): ~1 saat.

📋 Ön-Hazırlık Checklist (Onaydan ÖNCE)

🚀 Faz 1 — Apple ID’yi EAS’e Bağla (~5 dk)

1.1 EAS credentials session başlat

cd "C:/Users/hasan/OneDrive/Masaüstü/Asistan/VoiceRemind"
eas credentials --platform ios

1.2 Prompts’ları sırayla yanıtla

? Select build profile → preview (first test build)
? What do you want to do → Set up a new distribution certificate
? Apple ID → <senin apple email>
? Password → <apple şifre>
? 2FA code → <sms/app ile gelen>
? Which team → Individual (senin adın)

1.3 Certificate + Provisioning Profile oluştur

EAS otomatik şunları üretir:

1.4 Doğrula

eas credentials --platform ios
# "View current credentials" seç
# Listede şunları görmelisin:
#   ✓ Distribution Certificate: valid
#   ✓ Provisioning Profile: com.blaixs.VoiceRemind

🏗 Faz 2 — App Store Connect Uygulama Kaydı (~10 dk)

2.1 App Store Connect’e giriş

https://appstoreconnect.apple.com → Apple ID ile login

2.2 My Apps → “+” → New App

Doldurulacak alanlar:

Alan Değer
Platforms iOS
Name Voicely AI
Primary Language Turkish (Türkçe)
Bundle ID com.blaixs.VoiceRemind (dropdown’dan seç — EAS otomatik register etmiş olmalı)
SKU voicely-ai-ios-v1 (internal, any string)
User Access Full Access

→ Create

2.3 App Information bölümünde

Bu aşamada metadata doldurmayı erteleyebilirsin (build yüklendikten sonra da girilebilir). Ama şimdi yaparsan:

2.4 Availability → Territories

📦 Faz 3 — İlk iOS Build (~15 dk)

DİKKAT — Profile seçimi:

  • preview → distribution: internal → ad-hoc imza → sadece register edilmiş iPhone’lara EAS link ile install. TestFlight kabul ETMEZ. Sadece kişisel iPhone’da hızlı smoke test için.
  • production → varsayılan App Store imza → TestFlight + App Store yayını için doğru profile.

EAS Free quota ayda 15 iOS build. İki profile birden atmak yerine doğrudan production yeterli — kişisel iPhone’da test için TestFlight zaten ücretsiz dağıtım sağlıyor.

3.1 Production build’i tetikle (TestFlight için)

cd "C:/Users/hasan/OneDrive/Masaüstü/Asistan/VoiceRemind"
eas build --platform ios --profile production

İlk build sırasında EAS otomatik şunları yapar:

Eğer kişisel iPhone’da hızlı smoke test isteniyorsa (TestFlight onayını beklemeden), önce --profile preview ile ad-hoc build atılıp UDID register edilebilir. Ama TestFlight için mutlaka ayrıca production build gerekir — preview IPA’sı App Store Connect’e gönderilemez.

3.2 Build durumunu izle

3.3 Build başarılı olunca

Terminal çıktısında:

✔ Build finished
🔗 https://expo.dev/artifacts/eas/<build-id>.ipa

📲 Faz 4 — TestFlight Upload (~5 dk)

4.1 Submit

eas submit --platform ios --latest

Prompts:

? Apple ID → <senin email>
? Apple ID password → <cookie cached ise sormaz>
? Generate a new App Store Connect API Key? → Y
? Which app → Voicely AI (otomatik bulur)

Apple session cookie: İlk eas build sırasında 2FA + şifre girdiğinde fastlane cookie’yi ~/.app-store/auth/<email>/cookie altına kaydeder, ~30 gün geçerli. Submit anında session cache’den okur, şifre sormaz.

App Store Connect API Key: EAS otomatik oluşturup kendi sunucusunda saklar (Key ID + .p8 private key). Sonraki tüm submit’lerde reuse eder.

App-specific password (alternatif yol): Eğer cookie expire olmuşsa veya ilk seferse Apple “App ID password” istediğinde normal Apple ID şifren değil app-specific password gir: https://appleid.apple.com/account/manage → Sign-In and Security → App-Specific Passwords → + → “EAS Submit” → 16-karakterli şifreyi kopyala.

4.2 TestFlight’a propagation

4.3 “Missing Compliance” uyarısını çöz

Apple her build’de bu uyarıyı gösterir (export compliance). Biz app.json‘da ITSAppUsesNonExemptEncryption: false set ettik, yine de:

  1. TestFlight build’inin yanındaki “Manage” butonuna tıkla
  2. “Does your app use encryption?” → No
  3. Save

🧪 Faz 5 — iPhone’da Test (~sabır)

5.1 TestFlight app’i indir

iPhone App Store → “TestFlight” ara → Apple’ın resmi app’i

5.2 Uygulamayı ekle

Two ways:

5.3 Test Senaryoları

📸 Faz 6 — Screenshots Hazırla (~30 dk)

6.1 iPhone’dan 6 screenshot çek

Önerilen sıralama + hangi ekran:

# Ekran Görsel içerik
1 Dashboard Metric grid + bar chart + streak
2 Mikrofon basılı Pulse ring + “Dinliyorum” metni
3 Confirmation modal Transcript + reminder kartları
4 Reminders list Today/Tomorrow/This Week sections
5 Contact detail Profile + call/email buttons
6 Search Arama aktif + filtreli sonuçlar

6.2 Screenshot boyut seçimi

App Store Connect 2024-2026 itibarıyla şu kategorilerden en az birini kabul ediyor:

v1.0 deneyiminden: Kullanıcı 6.7”‘lik orijinalleri 1242×2688 (6.5”) boyutuna manuel resize etti ve App Store kabul etti. Submit butonu aktifleşti, “primary missing” uyarısı vermedi. Yani 6.5” tek başına yeterli; ama daha güvenli için 6.7” tab’ına da yüklemek tavsiye edilir.

6.3 iPad screenshot (zorunlu eğer supportsTablet: true)

app.json içinde ios.supportsTablet: true ise Apple iPad 13” Display (2064×2752) screenshot ister, yoksa Add for Review butonu gri kalır.

3 yol:

A) Gerçek iPad simulator’da çek (en doğru, macOS gerektirir):

# Mac üzerinde
xcrun simctl boot "iPad Pro 13-inch (M4)"
# Voicely AI'ı simülatörde aç, Cmd+S ile screenshot çek

B) iPhone screenshot’larını iPad canvas’a center-fit et (Windows-friendly, hızlı):

python scripts/generate_ipad_screenshots.py
# Source: VoiceRemind/iphone-screenshots/*.png|jpeg
# Output: VoiceRemind/ipad-screenshots/ipad_NN.png (2064×2752, dark navy #0F172A bg)

v1.0’da bu yol kullanıldı. Apple validator dimensions’ı kontrol eder, gerçek iPad UI’ı görmez. Kabul edildi.

C) app.json‘da supportsTablet: false yap ve iPad zorunluluğunu komple kaldır. Yeni build gerekir (1 EAS build slotu).

6.4 Upload

App Store Connect → 1.0 Prepare for Submission → Previews and Screenshots:

🏁 Faz 7 — Submit for Review (~10 dk)

7.1 Version metadata doldur

What’s New in This Version:

v1.0 — İlk sürüm!

• Sesli hatırlatıcı oluşturma (Türkçe AI)
• Mini CRM ile cari takibi
• Dashboard ve haftalık istatistikler
• Yerel bildirimler

Promotional Text (170 char):

Mikrofona basılı tut, Türkçe konuş, AI hatırlatıcını saniyeler içinde oluşturur. Müşteri takibi ve günlük yapılacaklar tek yerde.

Description: docs/store-listing.md → “Description” bölümündeki 4000 char metni kopyala.

Keywords (100 char, virgülle ayrılmış boşluksuz):

hatırlatıcı,sesli,AI,yapay zeka,hatırla,görev,CRM,müşteri,takip,ajanda,not,bildirim

Support URL: https://blaixs-max.github.io/VoiceRemind/support/ Marketing URL: https://blaixs-max.github.io/VoiceRemind/ (opsiyonel)

7.2 App Review Information

Alan Değer
Sign-in required Yes
Username reviewer@voicely.test (önceden Supabase’de oluştur)
Password Reviewer2026! (veya güçlü başka)
Notes “Mikrofona basılı tutarak ses kaydı yapın. Türkçe komut: ‘yarın saat 3’te toplantı’. AI confirmation modal’ı açılacak.”
Contact — First name Hasan
Contact — Last name
Contact — Email blaixs@gmail.com
Contact — Phone

7.3 Version Release

7.4 Submit for Review

Sağ üstte “Submit for Review” butonu → Submit

⏳ Faz 8 — Apple Review Bekleme

Ortalama süreler (2025/2026 için)

Reviewer email alırsan

Kabul olduğunda

Email: “Your app has been approved”

🎉 Canlı Olduktan Sonra

İlk saatler

İlk 48 saat — izle

Öncelik 1 başla

CLAUDE.md → Öncelik 1 (temel iyileştirmeler) → sıradaki feature’lar

🆘 Sık Karşılaşılan Hatalar

Hata Çözüm
ITMS-90717: Invalid App Store Icon Icon’da alpha var → scripts/process-icon.py ile yeniden üret
ITMS-90022: Invalid dimensions Icon 1024x1024 değil → aynı script’ten geçir
Build fails: “No bundle identifier” app.json → ios.bundleIdentifier doğru mu kontrol et
EAS credentials “Session expired” eas login tekrar çalıştır
TestFlight “Missing Compliance” Build detaylarında “Manage” → No encryption
Rejected: “Metadata missing” App Store Connect → App Review Information bölümünü doldur (demo hesap zorunlu)
Rejected: “Permission description generic” app.json → NSMicrophoneUsageDescription daha açıklayıcı yap
Description: “This field contains one or more invalid characters” Browser clipboard’da hidden Unicode (zero-width chars, smart quotes, emoji placeholder bytes). Çözüm: metni Notepad’e yapıştır → tekrar kopyala → App Store’a yapıştır. Emoji’leri ve em-dash’leri (—) ASCII’ye çevir. Bullet’lar için • yerine - kullan.
“Unable to Add for Review: You must upload a screenshot for 13-inch iPad displays” app.json supportsTablet: true olduğu için iPad screenshot zorunlu. Çözüm: scripts/generate_ipad_screenshots.py ile generate et veya supportsTablet: false yap (yeni build gerekir).
“Unable to Add for Review: You must respond to the required age ratings questions” App Information → Age Rating → Edit → 7-step questionnaire’i doldur (hepsi None/No → Result: 4+)
Save butonu kırmızı/gri ama spesifik hata yok Birden fazla zorunlu alan eksik. Çözüm: F12 DevTools → Network → Save’e tıkla → kırmızı request’in Response panel’inde tam hata mesajı görünür. Veya sol menüde sarı/turuncu noktalı sayfa(lar)ı ara (App Privacy, Age Rating, App Information).

📚 v1.0 Submission Lessons Learned (2026-04-29)

İlk gerçek submission’dan kazanılan deneyimler — sonraki sürümlerde zaman kazandıracak:

1. Description “Invalid Characters” tuzağı

2. iPad zorunluluğu

3. Age Rating questionnaire (7 step)

4. Demo Account hazırlığı

5. Reviewer Notes — bilingual + dictation rehberi

6. App Privacy “Published” zorunlu

7. Country availability

🚨 v1.0 Reject + v1.0.1 Resubmit Lessons (2026-04-30)

Reject: Submission ID ed0e119e-8f0b-4d3d-ba01-8b868b7dfce2, Guideline 5.1.1(v) — iki ayrı sorun:

  1. Account deletion eksik — App hesap açmaya izin veriyor ama silme yolu yok (Apple zorunlu kılıyor)
  2. Login wall yasağı — Apps may not require users to enter personal information to function, except when directly relevant to core functionality

Tek günde fix + resubmit: 2026-04-30 — kod yazımı + Edge Function deploy + smoke test + screen recording + Resolution Center reply.

1. Account Deletion zorunluluğu (5.1.1(v))

Apple kuralı:

Çözüm pattern (Supabase için):

Edge Function deploy yedek yolu:

2. Login Wall yasağı (5.1.1(v))

Apple kuralı:

Çözüm pattern (cloud-first app için):

3. Resubmit pratikleri

ASC’de yeni version oluşturmadan resubmit:

Resolution Center reply:

Screen recording attachment:

Reply format (kanıtlanmış kabul edici):

Recording 1 - Account Deletion + post-deletion sign-in re-try (physical iPhone):
https://www.youtube.com/shorts/<id>

Recording 2 - Guest login + manual reminder creation (physical iPhone):
https://www.youtube.com/shorts/<id>

4. Mimari tasarım dersi: cloud-first ≠ login-only

5. Privacy policy/implementation parity

Bu runbook her Apple submission öncesi güncellenir. Son update: 2026-04-30 akşam (v1.0.1 resubmit)