Mobil uygulama (iOS)

Multica'nın iOS istemcisi henüz App Store'da değil. Açık kaynak repodan bir Mac üzerinde Release sürümü derleyip kendi iPhone'unuza kurabilirsiniz. Henüz bir Android istemcisi yok.

Kurulan uygulama varsayılan olarak Multica Cloud'a bağlanır; mevcut hesabınızla giriş yapın. Çalışma alanları, işler, yorumlar ve çalıştırma geçmişi sunucuda yaşar — web veya Desktop'tan elle senkronize etmenize gerek yoktur.

Ön koşullar

Şunlara ihtiyacınız var:

• Xcode kurulu bir Mac;
• Xcode → Settings → Accounts altında oturum açılmış bir Apple ID;
• USB ile bağlı bir iPhone;
• iPhone'da Settings → Privacy & Security altında etkinleştirilmiş Developer Mode;
• Node.js, pnpm ve Git.

Xcode veya cihaz üzerinde geliştirme ortamı henüz kurulu değilse, önce Expo'nun iOS cihaz ortamı kurulumu rehberini tamamlayın.

iPhone'unuza kurma

Repoyu klonlayın ve bağımlılıkları kurun:

git clone https://github.com/multica-ai/multica.git
cd multica
pnpm install

Ardından repo kökünden çalıştırın:

pnpm ios:mobile:device:prod:release

Bu, Metro bağımlılığı olmayan bir Release sürümü derler ve bağlı iPhone'a kurar. İlk derleme iOS bağımlılıklarını indirir ve React Native'i derler; sonraki derlemeler Xcode'un önbelleğini kullanır.

iPhone uygulamanın açılmasını engellerse, Settings → General → VPN & Device Management altında geliştirici sertifikasına güvenin.

Ücretsiz imzalamanın 7 günlük sınırı

Ücretsiz bir Apple ID ile imzalanan uygulamalar yalnızca 7 gün çalışır. Bu süre dolduğunda, iPhone'u Mac'inize yeniden bağlayın ve yeniden imzalamak için aynı derleme komutunu tekrar çalıştırın.

Bir Apple Developer Program hesabıyla imzalanan derlemeler daha uzun süre geçerli kalır ve ayrıca TestFlight ile normal dağıtım için de kullanılabilir. Her iki imzalama türünde de, yeniden kurma veya yeniden imzalama sunucu tarafındaki veriyi asla kaybettirmez.

İmzalama hataları

Xcode No matching provisioning profiles found hatası verirse, varsayılan bundle identifier Apple ID'nize ait olmayabilir. Kontrol ettiğiniz bir ters alan adına geçin ve yeniden derleyin:

export EXPO_BUNDLE_IDENTIFIER_PROD=com.yourname.multica
pnpm ios:mobile:device:prod:release

Bu değerin yalnızca Apple Developer ekibinizde kullanılabilir olması gerekir; Multica hesabınızı veya çalışma alanlarınızı etkilemez.

Güncelleme

Kendi kurduğunuz iOS derlemesi otomatik güncellenmez. En son kodu çekin, bağımlılıkları güncelleyin ve yeniden derleyin:

git pull --ff-only
pnpm install
pnpm ios:mobile:device:prod:release

Kendi barındırdığınız bir örneğe bağlanma

Release derlemeleri API adresini uygulamaya gömer. Kendi barındırdığınız bir örneğe bağlanmak için önce apps/mobile/.env.production dosyasını düzenleyin:

EXPO_PUBLIC_API_URL=https://api.example.com
EXPO_PUBLIC_WEB_URL=https://app.example.com

EXPO_PUBLIC_API_URL zorunludur. EXPO_PUBLIC_WEB_URL isteğe bağlıdır ve "Copy link" ile "Open on web" gibi girişleri etkinleştirir; ayarlanmadığında bu menü öğeleri gizlenir.

Düzenledikten sonra derleme komutunu yeniden çalıştırın. iPhone'un API adresine erişebilmesi gerekir; bir LAN adresi kullanırken localhost yazmayın — iPhone'da bu, telefonun kendisini işaret eder.

Mobil geliştirme, Simulator kullanımı veya staging'e bağlanma için repodaki apps/mobile/README.md dosyasına bakın.

Sonraki adımlar

• Hızlı başlangıç — ilk çalıştırmanızı tamamlayın.
• Desktop uygulaması — desktop sekmeleri ve yerleşik daemon.
• Sorun giderme — bağlantı ve çalıştırma sorunlarını teşhis etme.