The rollercoaster of releasing an Android, iOS, and macOS app with Kotlin Multiplatform | Berlindroid November

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 @marcogomiero.com Senior Android Developer @ Airalo Google Developer Expert for Kotlin The rollercoaster of releasing an Android, iOS, and macOS app with Kotlin Multiplatform
2. @marcogomiero.com feedflow.dev/ FeedFlow
3. @marcogomiero.com feedflow.dev/ FeedFlow
4. @marcogomiero.com FeedFlow feedflow.dev/
5. @marcogomiero.com Distribution
6. @marcogomiero.com Android • “Easy” for an Android Developer • Sign the app • Upload to Play Store
7. @marcogomiero.com • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode (or manually on the CI) iOS
8. @marcogomiero.com
9. @marcogomiero.com • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode (or manually on the CI) iOS
10. @marcogomiero.com • JAR • “Manual” distribution • App Store macOS - JVM App ❌
11. @marcogomiero.com No Xcode, need to go manual \o/
12. @marcogomiero.com macOS - “Manual” distribution • Sign the app • Notarization
13. @marcogomiero.com https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution
14. @marcogomiero.com
15. @marcogomiero.com 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. @marcogomiero.com Notarization ./gradlew notarizeDmg
17. @marcogomiero.com macOS - “Manual” distribution • Sign the app • Notarization • Distribute the app
18. @marcogomiero.com
19. @marcogomiero.com macOS - App Store • Sign the app • Provisioning profiles • Upload to TestFlight
20. @marcogomiero.com Upload to TestFlight: Transporter (or CI) https://apps.apple.com/us/app/transporter/id1450874784?mt=12
21. @marcogomiero.com
22. @marcogomiero.com Fixed with Compose 1.6.10 https://github.com/JetBrains/compose-multiplatform/pull/4271
23. @marcogomiero.com compose { desktop { application { macOS { minimumSystemVersion = "12.0" } } } } }
24. @marcogomiero.com
25. @marcogomiero.com https://developer.apple.com/documentation/security/app_sandbox/protecting_user_data_with_app_sandbox
26. @marcogomiero.com Native libraries on JVM • Native libraries are embedded in the dependencies jar • When needed, they are extracted and loaded
27. @marcogomiero.com Without sandbox $TMPDIR
28. @marcogomiero.com With sandbox
29. @marcogomiero.com https://github.com/xerial/sqlite-jdbc
30. @marcogomiero.com https://github.com/xerial/sqlite-jdbc/tree/master/src/main/resources/org/sqlite/native/Mac/aarch64
31. @marcogomiero.com Packaging resources • <RESOURCES_ROOT_DIR>/common • <RESOURCES_ROOT_DIR>/<OS_NAME> • <RESOURCES_ROOT_DIR>/<OS_NAME>-<ARCH_NAME>
32. @marcogomiero.com Packaging resources
33. @marcogomiero.com compose.desktop.application.nativeDistributions { appResourcesRootDir.set(project.layout.projectDirectory.dir("resources")) }
34. @marcogomiero.com 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. @marcogomiero.com 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. @marcogomiero.com 🎉
37. @marcogomiero.com Crash Reporting & Logging
38. @marcogomiero.com Firebase Crashlytics
39. @marcogomiero.com https://github.com/touchlab/CrashKiOS
40. @marcogomiero.com
41. @marcogomiero.com Firebase Crashlytics Sentry Java SDK
42. @marcogomiero.com https://github.com/touchlab/Kermit
43. @marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
44. @marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
45. @marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )
46. @marcogomiero.com internal expect fun crashReportingLogWriter(): LogWriter actual fun crashReportingLogWriter(): LogWriter = CrashlyticsLogWriter() actual fun crashReportingLogWriter(): LogWriter = SentryLogWriter()
47. @marcogomiero.com class SentryLogWriter : LogWriter() { override fun isLoggable(tag: String, severity: Severity): Boolean { // .. } override fun log( severity: Severity, message: String, tag: String, throwable: Throwable? ) { // .. } }
48. @marcogomiero.com I18n
49. @marcogomiero.com https://github.com/adrielcafe/lyricist
50. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )
51. @marcogomiero.com 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. @marcogomiero.com 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. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )
54. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, regionCode: regionCode ) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
55. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, regionCode: regionCode ) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
56. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, single<FeedFlowStrings> { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }
57. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, single<FeedFlowStrings> { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }
58. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, single<FeedFlowStrings> { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }
59. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, single<FeedFlowStrings> { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }
60. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode, regionCode: regionCode ) _feedFlowStrings = KotlinDependencies.shared.getFeedFlowStrings() } private var _feedFlowStrings: FeedFlowStrings? var feedFlowStrings: FeedFlowStrings { return _feedFlowStrings! }
61. @marcogomiero.com val feedFlowStrings: Map<String, FeedFlowStrings> = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) Text(feedFlowStrings.searchHintTitle) func startKoin() { let languageCode = Locale.current.language.languageCode?.identifier let regionCode = Locale.current.region?.identifier let koinApplication = doInitKoinIos( languageCode: languageCode,
62. @marcogomiero.com Conclusions
63. @marcogomiero.com Conclusions • Start from things you already know • Go incrementally • Exploring other planets enriches your vision
64. @marcogomiero.com More reading https://www.marcogomiero.com/posts/2024/kmp-app-ci
65. @marcogomiero.com Thank you! Marco Gomiero Senior Android Developer @ Airalo Google Developer Expert for Kotlin > Twitter: @marcoGomier > Github: prof18 > Website: marcogomiero.com > Mastodon: androiddev.social/@marcogom > BlueSky: @marcogomiero.com
66. 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/