Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

@marcogomiero.com FeedFlow Compose Multiplatform SwiftUI feed fl ow.dev/ Kotlin Multiplatform

Slide 3

Slide 3 text

@marcogomiero.com feedflow.dev/ FeedFlow

Slide 4

Slide 4 text

@marcogomiero.com feedflow.dev/ FeedFlow

Slide 5

Slide 5 text

@marcogomiero.com FeedFlow feedflow.dev/

Slide 6

Slide 6 text

@marcogomiero.com Distribution

Slide 7

Slide 7 text

@marcogomiero.com Android • “Easy” for an Android Developer • Sign the app • Upload to Play Store

Slide 8

Slide 8 text

@marcogomiero.com • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode iOS

Slide 9

Slide 9 text

@marcogomiero.com

Slide 10

Slide 10 text

@marcogomiero.com • Sign the app • Provisioning profiles • Upload to TestFlight • All handled by Xcode (or manually on the CI) iOS

Slide 11

Slide 11 text

@marcogomiero.com macOS - JVM App

Slide 12

Slide 12 text

@marcogomiero.com No Xcode, need to go manual \o/

Slide 13

Slide 13 text

@marcogomiero.com • JAR • “Manual” distribution • App Store macOS - Distribution ❌

Slide 14

Slide 14 text

@marcogomiero.com macOS - “Manual” distribution • Sign the app • Notarization

Slide 15

Slide 15 text

@marcogomiero.com https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution

Slide 16

Slide 16 text

@marcogomiero.com

Slide 17

Slide 17 text

@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

Slide 18

Slide 18 text

@marcogomiero.com Notarization ./gradlew notarizeDmg

Slide 19

Slide 19 text

@marcogomiero.com macOS - “Manual” distribution • Sign the app • Notarization • Distribute the app

Slide 20

Slide 20 text

@marcogomiero.com

Slide 21

Slide 21 text

@marcogomiero.com macOS - App Store • Sign the app • Provisioning profiles • Upload to TestFlight

Slide 22

Slide 22 text

@marcogomiero.com Upload to TestFlight: Transporter (or CI) https://apps.apple.com/us/app/transporter/id1450874784?mt=12

Slide 23

Slide 23 text

@marcogomiero.com

Slide 24

Slide 24 text

@marcogomiero.com

Slide 25

Slide 25 text

@marcogomiero.com plist[PlistKeys.LSMinimumSystemVersion] = "10.13"

Slide 26

Slide 26 text

@marcogomiero.com Fixed with Compose 1.6.10 https://github.com/JetBrains/compose-multiplatform/pull/4271

Slide 27

Slide 27 text

@marcogomiero.com compose { desktop { application { macOS { minimumSystemVersion = "12.0" } } } } }

Slide 28

Slide 28 text

@marcogomiero.com

Slide 29

Slide 29 text

@marcogomiero.com

Slide 30

Slide 30 text

@marcogomiero.com https://developer.apple.com/documentation/security/app_sandbox/protecting_user_data_with_app_sandbox

Slide 31

Slide 31 text

@marcogomiero.com Native libraries on JVM • Native libraries are embedded in the dependencies jar • When needed, they are extracted and loaded

Slide 32

Slide 32 text

@marcogomiero.com Without sandbox $TMPDIR

Slide 33

Slide 33 text

@marcogomiero.com With sandbox

Slide 34

Slide 34 text

@marcogomiero.com Native libraries on JVM • Cannot load “random” native library • Signing and embedding in the binary is the way

Slide 35

Slide 35 text

@marcogomiero.com Find the native library 🕵 https://github.com/xerial/sqlite-jdbc

Slide 36

Slide 36 text

@marcogomiero.com https://github.com/xerial/sqlite-jdbc/tree/master/src/main/resources/org/sqlite/native/Mac/aarch64

Slide 37

Slide 37 text

@marcogomiero.com Embedding resources • /- • / • /common

Slide 38

Slide 38 text

@marcogomiero.com compose.desktop.application.nativeDistributions { appResourcesRootDir.set(project.layout.projectDirectory.dir("resources")) }

Slide 39

Slide 39 text

@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) } Load native libraries

Slide 40

Slide 40 text

@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) } Load native libraries

Slide 41

Slide 41 text

@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) } Load native libraries

Slide 42

Slide 42 text

@marcogomiero.com Future improvements 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

Slide 43

Slide 43 text

@marcogomiero.com 🎉

Slide 44

Slide 44 text

@marcogomiero.com Crash Reporting & Logging

Slide 45

Slide 45 text

@marcogomiero.com Firebase Crashlytics

Slide 46

Slide 46 text

@marcogomiero.com https://github.com/touchlab/CrashKiOS

Slide 47

Slide 47 text

@marcogomiero.com

Slide 48

Slide 48 text

@marcogomiero.com Firebase Crashlytics Sentry Java SDK

Slide 49

Slide 49 text

@marcogomiero.com Logging 🪵 https://github.com/touchlab/Kermit

Slide 50

Slide 50 text

@marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )

Slide 51

Slide 51 text

@marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )

Slide 52

Slide 52 text

@marcogomiero.com val logger = Logger( config = StaticConfig( logWriterList = listOf( platformLogWriter(), crashReportingLogWriter(), ), ), tag = "FeedFlow", )

Slide 53

Slide 53 text

@marcogomiero.com internal expect fun crashReportingLogWriter(): LogWriter actual fun crashReportingLogWriter(): LogWriter = CrashlyticsLogWriter() actual fun crashReportingLogWriter(): LogWriter = SentryLogWriter()

Slide 54

Slide 54 text

@marcogomiero.com class SentryLogWriter : LogWriter() { override fun isLoggable(tag: String, severity: Severity): Boolean { // .. } override fun log( severity: Severity, message: String, tag: String, throwable: Throwable? ) { // .. } }

Slide 55

Slide 55 text

@marcogomiero.com I18n

Slide 56

Slide 56 text

@marcogomiero.com https://github.com/adrielcafe/lyricist

Slide 57

Slide 57 text

@marcogomiero.com val feedFlowStrings: Map = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )

Slide 58

Slide 58 text

@marcogomiero.com val feedFlowStrings: Map = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, ) FeedFlowTheme { val lyricist = rememberFeedFlowStrings() ProvideFeedFlowStrings(lyricist) { MyAppEntrypoint() } }

Slide 59

Slide 59 text

@marcogomiero.com val feedFlowStrings: Map = 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)

Slide 60

Slide 60 text

@marcogomiero.com val feedFlowStrings: Map = mapOf( Locales.It to ItFeedFlowStrings, Locales.En to EnFeedFlowStrings, Locales.De to DeFeedFlowStrings, )

Slide 61

Slide 61 text

@marcogomiero.com val feedFlowStrings: Map = 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! }

Slide 62

Slide 62 text

@marcogomiero.com val feedFlowStrings: Map = 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! }

Slide 63

Slide 63 text

@marcogomiero.com val feedFlowStrings: Map = 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 { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }

Slide 64

Slide 64 text

@marcogomiero.com val feedFlowStrings: Map = 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 { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }

Slide 65

Slide 65 text

@marcogomiero.com val feedFlowStrings: Map = 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 { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }

Slide 66

Slide 66 text

@marcogomiero.com val feedFlowStrings: Map = 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 { when { languageCode == null -> EnFeedFlowStrings regionCode == null -> feedFlowStrings[languageCode] ?: EnFeedFlowStrings else -> { val locale = "${languageCode}_$regionCode" feedFlowStrings[locale] ?: feedFlowStrings[languageCode] ?: EnFeedFlowStrings } } }

Slide 67

Slide 67 text

@marcogomiero.com val feedFlowStrings: Map = 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! }

Slide 68

Slide 68 text

@marcogomiero.com val feedFlowStrings: Map = 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,

Slide 69

Slide 69 text

@marcogomiero.com Conclusions

Slide 70

Slide 70 text

@marcogomiero.com Conclusions • Start from things you already know • Go incrementally • Exploring other planets enriches your vision

Slide 71

Slide 71 text

@marcogomiero.com More reading https://www.marcogomiero.com/posts/2024/kmp-app-ci

Slide 72

Slide 72 text

@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

Slide 73

Slide 73 text

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/