Crashlytics kontrol panelinden okunabilir kilitlenme raporları alın

Firebase Crashlytics varsayılan olarak hata ayıklama simgenizi otomatik olarak işler (dSYM) dosyalarını kullanmanızı sağlar. Siz genellikle bu davranışı Crashlytics ürününün ilk kurulumu sırasında yapılandırın. size yardımcı olmak için çalışma komut dosyası ekleme uygulamanızın derleme aşamasında otomatik olarak dSYM dosyalarını yükleyen

Maalesef otomatik dSYM dosyalarınıza neden olabilecek birkaç durum var. başarısız olacaktır. Bu kılavuz, Crashlytics, uygulamanızın dSYM dosyalarını bulamıyor.

Xcode'un dSYM'leri otomatik olarak işleyebildiğinden ve dosyaları yükleyebildiğinden emin olun

Uygulamanızda Crashlytics uygulamasını kurarken bir çalıştırma komut dosyası yapılandırdınız dSYM'leri otomatik olarak işleyip dosyaları yükleyebilirsiniz.

Crashlytics çalıştırma komut dosyası yapılandırmanızın şu koşulları karşıladığından emin olun: ve Xcode 15 ile başlayan yeni gereksinimlere uygun olmalıdır. Eğer yapılandırma güncel değilse şu hatayı alıyor olabilirsiniz:
error: Info.plist Error Unable to process Info.plist at path ....

Özellikle, Xcode 15 ve sonraki sürümler için daha eksiksiz bir görebilirsiniz. Crashlytics çalıştırma komut dosyanız için (firebase-ios-sdk/Crashlytics/run) aşağıdakilere sahip olduğunuzdan emin olun: ayar:

  1. Derleme Aşamaları sekmesini tıklayın ve ardından Komut Dosyasını Çalıştır bölümünü genişletin.

  2. Giriş Dosyaları bölümünde, konumlara ait yolların bulunduğundan emin olun (aşağıdaki dosyalardan)

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
     
    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
     
    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
     
    $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
     
    $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)

Xcode'un dSYM üretip üretmediğini kontrol edin

Çoğunlukla dSYM dosyaları kayboluyor çünkü Xcode basit bir komut dosyası üretmiyor. gerekir. Yükleme başarısız olduğunda Crashlytics, "Eksik dSYM" hatasını gösterir. şurada uyarı: Firebase konsolu. Bu uyarıyı alırsanız önce Xcode'un doğru olup olmadığını kontrol edin. her derleme için doğru dSYM'yi üretmelisiniz:

  1. Projenizi Xcode'da açın ve Xcode'da proje dosyasını seçin. Gezgin'e dokunun.

  2. Ana derleme hedefinizi seçin.

  3. Hedefin Build Settings (Derleme Ayarları) sekmesini açıp Tümü'nü tıklayın.

  4. debug information format araması

  5. Hata Ayıklama Bilgi Biçimi'ni dSYM Dosyası ile DWARF olarak ayarlayın. en iyi uygulamaları paylaşacağız.

  6. Uygulamanızı yeniden oluşturun.

Kilitlenme raporlarınız artık Crashlytics kontrol paneli. Sorun devam ederse veya hatalarla karşılaşmamak için dSYM'lerinizi bulmayı ve bunları Crashlytics hizmetine manuel olarak yükleyebilirsiniz.

dSYM'lerinizi yerel bir makinede bulun

Tüm dSYM'lerinizi görüntülemek için aşağıdaki komutu çalıştırın Makinenizdeki UUID'ler ve eksik dSYM'yi ara:

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

dSYM'yi bulduktan sonra Crashlytics hizmetine manuel olarak yükleyin. mdfind komutu herhangi bir sonuç döndürmezse .app öğenizin bulunduğu Products dizini (varsayılan olarak Products dizini Derived Data konumundadır). Uygulamanız üretim sürümüne yayınlanırsa dSYM'sini, diskteki .xcarchive dizininde de arayabilirsiniz:

  1. Xcode'da Düzenleyici penceresini açın, ardından menüden uygulamanızı seçin liste'ye dokunun. Xcode, projeniz için arşivlerin bir listesini görüntüler.

  2. Finder'da görüntülemek istediğiniz arşivi Control tuşunu basılı tutarak tıklayın. Control tuşunu basılı tutarak tekrar tıklayın ve ardından Paket İçeriğini Göster'i tıklayın.

  3. .xcarchive içinde, şu şekilde oluşturulmuş dSYM'leri içeren bir dSYMs dizini: bir parçasıdır.

dSYM'lerinizi yükleyin

Crashlytics, dSYM dosyalarınızın yüklenmesi için birden çok yöntemi destekler: otomatik olarak veya manuel olarak.

(Önerilir) dSYM'lerinizi otomatik olarak işleyin ve dosyaları yükleyin

Crashlytics hizmetini ilk kez ayarlarken büyük olasılıkla bunu yapılandırmıştınız. en iyi uygulamaları paylaşacağız. Ancak, otomatik yüklemeler başarısız olursa yapılandırmanızın doğru olduğundan emin olun.

dSYM dosyalarınızı manuel olarak yükleyin

Otomatik yüklemeler başarısız olursa dSYM dosyalarınızı tercih edebilirsiniz.

  • 1. Seçenek: Konsol tabanlı "Sürükle ve Bırak" işlevini kullanma bir ZIP dosyası yükleme seçeneği dSYM dosyalarınızı içeren bir dosya ( Firebase konsolu > Crashlytics dSYM'ler sekmesi).

  • 2. Seçenek: Çağrı yapabileceğiniz upload-symbols komut dosyasını kullanın dSYM dosyalarınızı manuel olarak yüklemenizi sağlar. upload-symbols komut dosyası için aşağıdaki seçeneklerden birini kullanın:

    • Seçenek A: Derleme işleminize aşağıdaki satırı ekleyin:

      find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}

    • B seçeneği: Komut dosyasını doğrudan terminalinizden çalıştırın:

      /PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs

    Bu komut dosyasıyla ilgili kullanım notları ve ek talimatlar için şu komutu çalıştırın: --help parametresiyle upload-symbols.