The rollercoaster of releasing an Android, iOS, and macOS app with Kotlin Multiplatform | droidcon Berlin

With the rise of Kotlin Multiplatform, the possibility of expanding to multiple platforms has increased, especially for Android Developers. It's easier than before to build for other platforms.

But how to release your app to multiple platforms?

In this talk, I will share all the things I've learned around distributing FeedFlow, an Android, iOS, and macOS app built with Kotlin Multiplatform, coming from an Android development background.

We will cover the deployment of the binary, automating everything with CI, crash reporting, logging, internationalization, and all you need to know to successfully distribute your KMP app.

Transcript

1. Marco Gomiero @marcoGomier Senior Android Developer @ Airalo Google Developer Expert for Kotlin The rollercoaster of releasing an Android, iOS, and macOS app with Kotlin Multiplatform
2. @marcoGomier feedflow.dev/ FeedFlow
3. @marcoGomier feedflow.dev/ FeedFlow
4. @marcoGomier FeedFlow feedflow.dev/
5. @marcoGomier Distribution
6. @marcoGomier Android • “Easy” for an Android Developer • Sign the app • Upload to Play Store
7. @marcoGomier • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode (or manually on the CI) iOS
8. @marcoGomier
9. @marcoGomier • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode (or manually on the CI) iOS
10. @marcoGomier • JAR • “Manual” distribution • App Store macOS - JVM App ❌
11. @marcoGomier No Xcode, need to go manual \o/
12. @marcoGomier macOS - “Manual” distribution • Sign the app • Notarization
13. @marcoGomier https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution
14. @marcoGomier
15. @marcoGomier Notarization $ xcrun notarytool submit $BINARY_PATH --apple-id $APPLE_ID_NOTARIZATION --password $NOTARIZATION_PWD --team-id $APPSTORE_TEAM_ID --wait $ xcrun stapler staple $BINARY_PATH
16. @marcoGomier Notarization ./gradlew notarizeDmg
17. @marcoGomier macOS - “Manual” distribution • Sign the app • Notarization • Distribute the app
18. @marcoGomier
19. @marcoGomier macOS - App Store • Sign the app • Provisioning profiles • Upload to TestFlight
20. @marcoGomier Upload to TestFlight: Transporter (or CI) https://apps.apple.com/us/app/transporter/id1450874784?mt=12
21. @marcoGomier
22. @marcoGomier Fixed with Compose 1.6.10 https://github.com/JetBrains/compose-multiplatform/pull/4271
23. @marcoGomier compose { desktop { application { macOS { minimumSystemVersion = "12.0" } } } } }
24. @marcoGomier
25. @marcoGomier https://developer.apple.com/documentation/security/app_sandbox/protecting_user_data_with_app_sandbox
26. @marcoGomier Native libraries on JVM • Native libraries are embedded in the dependencies jar • When needed, they are extracted and loaded
27. @marcoGomier Without sandbox $TMPDIR
28. @marcoGomier With sandbox
29. @marcoGomier https://github.com/xerial/sqlite-jdbc
30. @marcoGomier https://github.com/xerial/sqlite-jdbc/tree/master/src/main/resources/org/sqlite/native/Mac/aarch64
31. @marcoGomier Packaging resources • <RESOURCES_ROOT_DIR>/common • <RESOURCES_ROOT_DIR>/<OS_NAME> • <RESOURCES_ROOT_DIR>/<OS_NAME>-<ARCH_NAME>
32. @marcoGomier Packaging resources
33. @marcoGomier compose.desktop.application.nativeDistributions { appResourcesRootDir.set(project.layout.projectDirectory.dir("resources")) }
34. @marcoGomier val isSandboxed = System.getenv("APP_SANDBOX_CONTAINER_ID") != null if (isSandboxed) { val resourcesPath = System.getProperty("compose.application.resources.dir") // sqlite-jdbc System.setProperty("org.sqlite.lib.path", resourcesPath) }
35. @marcoGomier https://slack-chats.kotlinlang.org/t/16371916/hey-there-wave-i-m-trying-to-publish-my-app-on-the-mac-app-s#0be57312-7e43-4d30-add9-1cd5a0b7421b
36. @marcoGomier 🎉
37. @marcoGomier Crash Reporting & Logging
38. @marcoGomier Firebase Crashlytics
39. @marcoGomier https://github.com/touchlab/CrashKiOS
40. @marcoGomier
41. @marcoGomier Firebase Crashlytics Sentry Java SDK
42. @marcoGomier https://github.com/touchlab/Kermit
43. @marcoGomier val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
44. @marcoGomier val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
45. @marcoGomier val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
46. @marcoGomier internal expect fun crashReportingLogWriter(): LogWriter actual fun crashReportingLogWriter(): LogWriter = CrashlyticsLogWriter() actual fun crashReportingLogWriter(): LogWriter = SentryLogWriter()
47. @marcoGomier class SentryLogWriter : LogWriter() { override fun isLoggable(tag: String, severity: Severity): Boolean { // .. } override fun log( severity: Severity, message: String, tag: String, throwable: Throwable? ) { // .. } }
48. @marcoGomier I18n
49. @marcoGomier https://github.com/adrielcafe/lyricist
50. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )
51. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) FeedFlowTheme { val lyricist = rememberFeedFlowStrings() ProvideFeedFlowStrings(lyricist) { MyAppEntrypoint() } }
52. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) FeedFlowTheme { val lyricist = rememberFeedFlowStrings() ProvideFeedFlowStrings(lyricist) { MyAppEntrypoint() } } Text(text = LocalFeedFlowStrings.current.feedUrl)
53. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )
54. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let langCode = Locale.current.language.languageCode?.identifier ?? "en" let koinApplication = KoinIOSKt.doInitKoinIos(languageCode: langCode) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
55. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let langCode = Locale.current.language.languageCode?.identifier ?? "en" let koinApplication = KoinIOSKt.doInitKoinIos(languageCode: langCode) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
56. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let langCode = Locale.current.language.languageCode?.identifier ?? "en" let koinApplication = KoinIOSKt.doInitKoinIos(languageCode: langCode) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() single<FeedFlowStrings> { feedFlowStrings[languageCode] ?: EnFeedFlowStrings }
57. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let langCode = Locale.current.language.languageCode?.identifier ?? "en" let koinApplication = KoinIOSKt.doInitKoinIos(languageCode: langCode) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
58. @marcoGomier val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let langCode = Locale.current.language.languageCode?.identifier ?? "en" let koinApplication = KoinIOSKt.doInitKoinIos(languageCode: langCode) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() Text(feedFlowStrings.searchHintTitle)
59. @marcoGomier Conclusions
60. @marcoGomier Conclusions • Start from things you already know • Go incrementally • Exploring other planets enriches your vision
61. @marcoGomier More reading https://www.marcogomiero.com/posts/2024/kmp-app-ci
62. @marcoGomier Thank you! > Twitter: @marcoGomier > Github: prof18 > Website: marcogomiero.com > Mastodon: androiddev.social/@marcogom Marco Gomiero Senior Android Developer @ Airalo Google Developer Expert for Kotlin
63. Bibliography / Useful Links • https: / / feedflow.dev/ • https: / / developer.apple.com/documentation/security/notarizing_macos_software_before_distribution • https: / / help.apple.com/itc/transporteruserguide/en.lproj/static.html#apd70774093eddb4 • https: / / developer.apple.com/documentation/security/app_sandbox/protecting_user_data_with_app_sandbox • https: / / github.com/JetBrains/compose-multiplatform/blob/master/tutorials/Native_distributions_and_local_execution/README.md#adding-files-to- packaged-application • https: / / slack-chats.kotlinlang.org/t/16371916/hey-there-wave-i-m-trying-to-publish-my-app-on-the-mac-app-s#0be57312-7e43-4d30- add9-1cd5a0b7421b • https: / / firebase.google.com/products/crashlytics • https: / / docs.sentry.io/platforms/java/ • https: / / github.com/touchlab/CrashKiOS • https: / / github.com/touchlab/Kermit • https: / / github.com/adrielcafe/lyricist • https: / / www.jetbrains.com/help/kotlin-multiplatform-dev/compose-images-resources.html#strings • https: / / www.marcogomiero.com/posts/2024/kmp-ci-android • https: / / www.marcogomiero.com/posts/2024/kmp-ci-ios • https: / / www.marcogomiero.com/posts/2024/kmp-ci-macos-github-releases • https: / / www.marcogomiero.com/posts/2024/kmp-ci-macos-appstore • https: / / www.marcogomiero.com/posts/2024/compose-macos-app-store/