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ışı şurada Crashlytics'in 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'i 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 anda olduğundan 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. oluşturabilirsiniz. Yükleme başarısız olduğunda Crashlytics, "Eksik dSYM" hatasını gösteriyor ş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 All (Tümü) seçeneğini 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 Crashlytics'e 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'e 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ı yüklemek için birden fazla yöntemi destekler: otomatik olarak veya manuel olarak gerçekleştirilebilir.

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

Crashlytics'i ilk kurduğunuzda büyük olasılıkla bunu yapılandırmıştınız en iyi uygulamaları paylaşacağız. Ancak, otomatik yüklemeler yapılandırmanın doğru olup olmadığını kontrol edin.

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.