Символизация отчётов об ошибках 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, эти пакеты затем автоматически обнаруживаются 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.