Символизация отчетов об ошибках iOS

Создание .dSYM для релизных бинарников Kotlin

Для символизации адресов в коде Kotlin (например, для элементов стека, соответствующих коду Kotlin) требуется пакет для кода Kotlin.

По умолчанию компилятор Kotlin/Native генерирует .dSYM для релизных (т. е. оптимизированных) бинарников на платформах Darwin. Это можно отключить с помощью соответствующего флага компилятора. В то же время этот параметр отключен по умолчанию для других платформ. Чтобы включить его, используйте соответствующий параметр компилятора.

kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
        binaries.all {
            freeCompilerArgs += "-Xadd-light-debug={enable|disable}"
        }
    }
}

kotlin {
    targets.withType(org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget) {
        binaries.all {
            freeCompilerArgs += "-Xadd-light-debug={enable|disable}"
        }
    }
}

В проектах, созданных из шаблонов IntelliJ IDEA или AppCode, эти пакеты .dSYM автоматически обнаруживаются Xcode.

Сделать фреймворки статическими при использовании перестроения из bitcode

Перестроение фреймворка, созданного на Kotlin, из bitcode делает устаревшими оригинальные .dSYM. Если это выполняется локально, убедитесь, что при символизации отчетов об ошибках используется обновленный .dSYM.

Если перестройка выполняется со стороны App Store, то .dSYM перестроенного динамического фреймворка, похоже, отбрасывается и не загружается из App Store Connect. В этом случае может потребоваться сделать фреймворк статическим.

kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
        binaries.withType<org.jetbrains.kotlin.gradle.plugin.mpp.Framework> {
            isStatic = true
        }
    }
}

kotlin {
    targets.withType(org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget) {
        binaries.withType(org.jetbrains.kotlin.gradle.plugin.mpp.Framework) {
            isStatic = true
        }
    }
}

Декодирование встроенных кадров стека

Xcode, похоже, некорректно декодирует элементы стека вызовов встроенных функций (эти функции не только Kotlin, но также функции, встроенные при оптимизации машинного кода). Поэтому некоторые элементы стека могут отсутствовать. В этом случае рассмотрите возможность использования lldb для обработки отчета об ошибке, уже просимволизированного Xcode, например:

$ lldb -b -o "script import lldb.macosx" -o "crashlog file.crash"

Эта команда должна вывести отчет об ошибке, дополнительно обработанный и включающий встроенные элементы стека.

Дополнительные сведения можно найти в документации LLDB.