@IsuruKusumal KotlinConf’23 Amsterdam How to Publish Your First Multiplatform Library
 Isuru Rajapakse Android Developer, Motorola Solutions

Introduction https: // github.com/xxfast/KStore

Introduction > Lifecycle of a library

Lifecycle Incubate Develop Publish Maintain Introduction > Lifecycle of a library

@v1 @v2 @v3 Introduction > Lifecycle of a library

Top 10 Essential Tools YOU NEED! to Publish Your Own Multiplatform Library! Introduction

Develop Lifecycle of a library Incubate

1. In ation cub spir Incubate > Inspire

Incubate > Inspire

interface ValueStore { fun get(): Maybe fun observePut(value: T): Single fun observe(): Observable?> fun observeClear(): Completable class ValueUpdate(val value: T?) } RxStore Incubate > Inspire

class KStore { suspend fun get(): T? suspend fun put(value: T) val updates: Flow suspend fun clear() } KStore Incubate > Inspire

ate ncub sol 2. I Incubate > Isolate

Incubate > Isolate YourProject YourLibrary

YourProject YourLibrary commonMain kotlin au.com.myproject screens feature-1 feature-2 utils MyLibrary Incubate > Isolate

@RequiresOptIn(message = "This API is experimental”) @Retention(BINARY) @Target(CLASS, FUNCTION,PROPERTY) annotation class ExperimentalMyLibraryApi feature-1 feature-2 utils MyLibrary YourProject YourLibrary Incubate > Isolate https: // github.com/Kotlin/api-guidelines ExperimentalMyLibraryApi

@ExperimentalMyLibraryApi fun interface NewApi { fun doSomethingNew() = TODO() } feature-1 feature-2 utils MyLibrary YourProject YourLibrary Incubate > Isolate https: // github.com/Kotlin/api-guidelines ExperimentalMyLibraryApi @OptIn(ExperimentalMyLibraryApi :: class) val myApi = NewApi { . . }

Develop Lifecycle of a library Incubate

Lifecycle of a library Develop

3. Setup CI Early! Develop > Continuous Integration

Github Actions Develop > Continuous Integration

name: Build on: .. jobs: check: .. build: .. release: if: ${{ github.event_name != 'pull_request' }} needs: build publish: if: ${{ github.event_name != 'pull_request' }} needs: build check release publish build Develop > Continuous Integration

build name: Build on: .. jobs: check: .. build: strategy: matrix: config: [ { target: android, os: ubuntu-latest, .. }, { target: apple, os: macos-latest, .. }, { target: windows, os: windows-latest, .. } { target: linux, os: ubuntu-latest, .. }, { target: js, os: ubuntu-latest, .. }, { target: desktop, os: ubuntu-latest, .. }, ] runs-on: ${{ matrix.config.os }} check release publish ▾ Matrix: build Build android Build apple Build desktop Build js Build linux Develop > Continuous Integration

build name: Build on: .. jobs: check: .. build: strategy: matrix: config: [ { os: ubuntu-latest, tasks: testReleaseUnitTest .. }, { os: macos-latest, tasks: appleTest, .. }, { os: windows-latest, tasks: windowsTest, .. } { os: ubuntu-latest, tasks: linuxTest, .. }, { os: ubuntu-latest, tasks: jsTest .. }, { os: ubuntu-latest, tasks: desktopTest, .. }, ] runs-on: ${{ matrix.config.os }} check release publish ▾ Matrix: build Build android Build apple Build desktop Build js Build linux Develop > Test

4. Declare Public API! Develop > Public API

YourLibrary Public API 🤏 Develop > Public API

YourLibrary explicitApi() @SinceKotlin("1.4.0") explicitApi() Public API Develop > Public API

YourLibrary interface NewApi { fun doSomethingNew() = TODO() } Public API Develop > Public API

YourLibrary Public API public interface NewApi { public fun doSomethingNew(): Nothing = TODO() } Develop > Public API

5. Don’t break Compatibility! Develop > Compatibility

Develop > Compatibility 1.0.1 2.1.2 1.1.0 2.0.0 YourProject YourLibrary +minor/patch +major 2.1.3 +minor/patch https: // semver.org/

kotlinlang.org/docs/jvm-api-guidelines-backward-compatibility.html Develop > Compat . . “Backward-compatible code allows clients of newer API versions to use the same API code that they used with an older API version.”

Develop > Compatibility https: / / github.com/Kotlin/binary-compatibility-validator

Develop > Compatibility

Develop > Compatibility

Develop > Compatibility build check ▾ Matrix: build Build android Build apple Build desktop Build js Build linux name: Build on: .. jobs: check: steps: - name: Check api run: ./gradlew apiCheck release publish

Develop > Compatibility

Publish Lifecycle of a library Develop

Lifecycle of a library Publish

6. Document everything! Publish / Documentation

plugins { kotlin("multiplatform") id("org.jetbrains.dokka") version "1.8.10" } Publish > Documentation https: // github.com/Kotlin/dokka

Publish > Documentation

name: Build jobs: publish: if: ${{ github.event_name != 'pull_request' }} steps: - name: Generate docs with dokka run: ./gradlew dokkaHtml - name: Upload artifact uses: actions/upload-pages-artifact@v1 with: path: ${{ github.workspace }}/kstore/build/dokka/html - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v1 check release publish build Publish > Documentation ▾ Matrix: build

7. Release the Kraken! Publish / Release

Publish / Release repositories { mavenCentral() } /** Warning ⚠ Incoming lots of configuration! * 1. Setup and link your OSSRH repository * 2. Include sources + documentation * 3. Sign your artefacts * */ https: // kotlinlang.org/docs/multiplatform-publish-lib.html

publishing { repositories { maven { val isSnapshot = version.toString().endsWith("SNAPSHOT") val destination = if (!isSnapshot) "https: // s01.oss.sonatype.org/service/local/stagi else "https: // s01.oss.sonatype.org/content/repositories/snapshots" url = uri(destination) credentials { username = gradleLocalProperties(rootDir).getProperty("sonatypeUse password = gradleLocalProperties(rootDir).getProperty("sonatypePas } plugins { id("maven-publish") id("signing") } Publish / Release https: // central.sonatype.org/publish/publish-guide/ // 1. Link OSSRH repository

credentials { username = gradleLocalProperties(rootDir).getProperty("sonatypeUse password = gradleLocalProperties(rootDir).getProperty("sonatypePas } } } publishing { val javadocJar = tasks.register("javadocJar") { dependsOn(tasks.dokkaHtml) archiveClassifier.set("javadoc") from("$buildDir/dokka") } publications { withType { artifact(javadocJar) pom { name.set("KStore") description.set("A tiny Kotlin multiplatform library that assists licenses { Publish / Release https: // central.sonatype.org/publish/publish-guide/ // 2. Include sources + documentation

signing { useInMemoryPgpKeys( gradleLocalProperties(rootDir).getProperty("gpgKeySecret"), gradleLocalProperties(rootDir).getProperty("gpgKeyPassword"), ) sign(publishing.publications) } Publish / Release https: // central.sonatype.org/publish/publish-guide/ // 3. Sign your artefacts

Publish / Release https: // central.sonatype.org/publish/publish-guide/

release: if: ${{ github.event_name != 'pull_request' }} runs-on: macos-latest needs: - build steps: - name: Write secrets to local.properties if: ${{ github.event_name != 'pull_request' }} run: | echo sonatypeUsername="${SONATYPE_USERNAME}" >> "local. echo sonatypePassword="${SONATYPE_PASSWORD}" >> "local. echo gpgKeyPassword="${GPG_KEY_PASSWORD}" >> "local.pro echo gpgKeySecret="${GPG_KEY_SECRET}" >> "local.propert env: SONATYPE_USERNAME: ${{ secrets.SONATYPE_USERNAME }} SONATYPE_PASSWORD: ${{ secrets.SONATYPE_PASSWORD }} GPG_KEY_PASSWORD: ${{ secrets.GPG_KEY_PASSWORD }} GPG_KEY_SECRET: ${{ secrets.GPG_KEY_SECRET }} - name: Release to sonatype run: ./gradlew publishAllPublicationsToMavenRepository check release publish build Publish / Release ▾ Matrix: build

Publish / Release

Maintain Lifecycle of a library Publish

Lifecycle of a library Maintain

8. Coverage w/ Kover Maintain / Code Coverage

No content

Maintain > Code Coverage https: // github.com/Kotlin/kotlinx-kover

Maintain > Code Coverage plugins { kotlin("multiplatform") id("org.jetbrains.kotlinx.kover") version "0.6.1" }

name: Build jobs: check: steps: - name: Generate kover coverage report run: ./gradlew koverXmlReport - name: Add coverage report to PR if: ${{ github.event_name == 'pull_request' }} id: kover uses: mi-kas/kover-report@v1 with: path: ${{ github.workspace }}/kstore/build/reports/kover/x token: ${{ secrets.GITHUB_TOKEN }} title: Code Coverage update-comment: true min-coverage-overall: 80 min-coverage-changed-files: 80 check release publish build Maintain > Code Coverage ▾ Matrix: build https: // github.com/mi-kas/kover-report

Maintain > Code Coverage

9. Let the bots do the bumps! Maintain / Dependency Management

Maintain > Dependency Mgmt .. https: // docs.gradle.org/current/userguide/platforms.html

Maintain > Dependency Management

https: // github.com/joreilly/Confetti Maintain > Dependency Management

Maintain > ? 10. Have fun with(kotlin)!

Thank you,
 and don’t forget
 to vote @IsuruKusumal KotlinConf’23 Amsterdam