Prepare version 3.1.1-0.1.0

.github/workflows/release.yaml

@@ -0,0 +1,37 @@
+name: release
+
+on:
+  push:
+    tags:
+      - '**'
+
+env:
+  GRADLE_OPTS: "-Dorg.gradle.jvmargs=-Xmx4g -Dorg.gradle.daemon=false -Dkotlin.incremental=false"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-java@v3
+        with:
+          distribution: 'zulu'
+          java-version: 11
+
+      - run: ./gradlew publish
+        if: ${{ github.repository == 'cashapp/multiplatform-paging' }}
+        env:
+          ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.SONATYPE_NEXUS_USERNAME }}
+          ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.SONATYPE_NEXUS_PASSWORD }}
+          ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.ARTIFACT_SIGNING_PRIVATE_KEY }}
+
+      - uses: ffurrer2/extract-release-notes@v1
+        id: release_notes
+
+      - uses: softprops/action-gh-release@v1
+        with:
+          body: ${{ steps.release_notes.outputs.release_notes }}
+          files: |
+            zipline-cli/build/distributions/zipline-cli-*.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+## [Unreleased]
+
+
+## [3.1.1-0.1.0] - 2022-11-08
+
+Initial release.

build.gradle.kts

@@ -27,7 +27,7 @@ allprojects {
     @Suppress("UnstableApiUsage")
     configure<MavenPublishBaseExtension> {
       publishToMavenCentral(SonatypeHost.DEFAULT)
-      signAllPublications()
+//      signAllPublications()
       pom {
         description.set("Packages AndroidX's Paging library for Kotlin/Multiplatform.")
         name.set(project.name)

docs/releasing.md

@@ -0,0 +1,42 @@
+# Releasing
+
+1. Update the `version` in `build.gradle.kts` to the release version.
+
+2. Update the `CHANGELOG.md`:
+  1. Change the `Unreleased` header to the release version.
+  2. Add a link URL to ensure the header link works.
+  3. Add a new `Unreleased` section to the top.
+
+3. Update the `README.md` so the "Download" section reflects the new release version and the
+   snapshot section reflects the next "SNAPSHOT" version.
+
+4. Commit
+
+   ```
+   $ git commit -am "Prepare version X.Y.X"
+   ```
+
+5. Tag
+
+   ```
+   $ git tag -am "Version X.Y.Z" X.Y.Z
+   ```
+
+6. Update the `version` in `build.gradle.kts` to the next "SNAPSHOT" version.
+
+7. Commit
+
+   ```
+   $ git commit -am "Prepare next development version"
+   ```
+
+8. Push!
+
+   ```
+   $ git push && git push --tags
+   ```
+
+   This will trigger a GitHub Action workflow which will create a GitHub release and upload the
+   release artifacts to Sonatype Nexus.
+
+9. Visit [Sonatype Nexus](https://oss.sonatype.org/) and promote the artifact.

gradle/libs.versions.toml

@@ -39,4 +39,4 @@ kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
 kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
 kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
 kotlin-native-cocoapods = { id = "org.jetbrains.kotlin.native.cocoapods", version.ref = "kotlin" }
-mavenPublish = { id = "com.vanniktech.maven.publish", version.ref = "maven-publish" }
+mavenPublish = { id = "com.vanniktech.maven.publish.base", version.ref = "maven-publish" }

paging-common/build.gradle.kts

@@ -1,3 +1,7 @@
+import com.vanniktech.maven.publish.JavadocJar
+import com.vanniktech.maven.publish.KotlinMultiplatform
+import com.vanniktech.maven.publish.MavenPublishBaseExtension
+
 plugins {
   alias(libs.plugins.kotlin.multiplatform)
   alias(libs.plugins.mavenPublish)
@@ -55,3 +59,9 @@ kotlin {
     }
   }
 }
+
+configure<MavenPublishBaseExtension> {
+  configure(
+    KotlinMultiplatform(javadocJar = JavadocJar.Empty())
+  )
+}

paging-runtime/build.gradle.kts

@@ -1,3 +1,7 @@
+import com.vanniktech.maven.publish.JavadocJar
+import com.vanniktech.maven.publish.KotlinMultiplatform
+import com.vanniktech.maven.publish.MavenPublishBaseExtension
+
 plugins {
   alias(libs.plugins.kotlin.multiplatform)
   alias(libs.plugins.mavenPublish)
@@ -30,3 +34,9 @@ kotlin {
     }
   }
 }
+
+configure<MavenPublishBaseExtension> {
+  configure(
+    KotlinMultiplatform(javadocJar = JavadocJar.Empty())
+  )
+}