chore: cut release

.editorconfig

@@ -11,3 +11,8 @@ indent_style = tab
 indent_size = 2
 trim_trailing_whitespace = true
 insert_final_newline = true
+
+[*.{kt,kts}]
+ktlint_code_style = ktlint_official
+ktlint_standard_keyword-spacing = disabled
+ktlint_standard_annotation = disabled

.github/actions/decode_signing_key_action/action.yml

@@ -0,0 +1,19 @@
+name: Decode signing key
+description: 'Decodes gpg key into file'
+inputs:
+  signing_key_file:
+    description: 'Signing key file'
+    required: true
+    default: ''
+  signing_file_path:
+    description: 'Signing file path'
+    required: true
+    default: ''
+runs:
+  using: "composite"
+  steps:
+    # After decoding the secret key, place the file in signing_file_path
+    - run: |
+        echo "${{inputs.signing_key_file}}" > ~/secretKey.gpg.b64
+        base64 -d ~/secretKey.gpg.b64 > ${{ inputs.signing_file_path }}
+      shell: bash

.github/actions/publish_all_modules/action.yml

@@ -0,0 +1,35 @@
+name: 'Publish All Modules'
+description: 'Publishes all modules'
+inputs:
+  sonatype_user:
+    description: 'Sonatype user'
+    required: true
+    default: ''
+  sonatype_password:
+    description: 'Sonatype password'
+    required: true
+    default: ''
+  signing_key_id:
+    description: 'Signing key id'
+    required: true
+    default: ''
+  signing_key_password:
+    description: 'Signing key password'
+    required: true
+    default: ''
+  signing_key_file:
+    description: 'Signing key file'
+    required: true
+    default: ''
+runs:
+  using: "composite"
+  steps:
+    - run: |
+        ./gradlew --stacktrace clean publishToSonatype closeAndReleaseSonatypeStagingRepository
+      shell: bash
+      env:
+        SONATYPE_NEXUS_USERNAME: ${{ inputs.sonatype_user }}
+        SONATYPE_NEXUS_PASSWORD: ${{ inputs.sonatype_password }}
+        SIGNING_KEY_ID: ${{ inputs.signing_key_id }}
+        SIGNING_KEY_PASSWORD: ${{ inputs.signing_key_password }}
+        SIGNING_KEY_FILE: ${{ inputs.signing_key_file }}

.github/workflows/build-demo.yml

@@ -0,0 +1,53 @@
+name: Build Demo
+on:
+  pull_request: {}
+  workflow_dispatch: {}
+  workflow_call:
+    secrets:
+      SIGNING_KEY_ID:
+        description: 'Secret Key ID'
+        required: true
+      SIGNING_KEY_FILE:
+        description: 'Secret Key'
+        required: true
+      SIGNING_KEY_PASSWORD:
+        description: 'Secret Password'
+        required: true
+
+concurrency:
+  group: build-demo-${{ github.event.number }}
+  cancel-in-progress: true
+
+jobs:
+  build-demo:
+    name: Build Demo
+    runs-on: ubuntu-latest
+
+    env:
+      SIGNING_KEY_FILE_PATH: /home/runner/secretKey.gpg
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Decode Signing Key
+        uses: ./.github/actions/decode_signing_key_action
+        with:
+          signing_key_file: ${{ secrets.SIGNING_KEY_FILE }}
+          signing_file_path: ${{ env.SIGNING_KEY_FILE_PATH }}
+
+      - name: Assemble
+        run: ./gradlew --stacktrace :demo:assemble
+        env:
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}
+          SIGNING_KEY_FILE: ${{ env.SIGNING_KEY_FILE_PATH }}
+
+      - run: echo "Build status report=${{ job.status }}."

.github/workflows/build.yml

@@ -0,0 +1,53 @@
+name: Build Library
+on:
+  pull_request: {}
+  workflow_dispatch: {}
+  workflow_call:
+    secrets:
+      SIGNING_KEY_ID:
+        description: 'Secret Key ID'
+        required: true
+      SIGNING_KEY_FILE:
+        description: 'Secret Key'
+        required: true
+      SIGNING_KEY_PASSWORD:
+        description: 'Secret Password'
+        required: true
+
+concurrency:
+  group: build-${{ github.event.number }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build Library
+    runs-on: ubuntu-latest
+
+    env:
+      SIGNING_KEY_FILE_PATH: /home/runner/secretKey.gpg
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Decode Signing Key
+        uses: ./.github/actions/decode_signing_key_action
+        with:
+          signing_key_file: ${{ secrets.SIGNING_KEY_FILE }}
+          signing_file_path: ${{ env.SIGNING_KEY_FILE_PATH }}
+
+      - name: Assemble
+        run: ./gradlew --stacktrace :library:assemble
+        env:
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}
+          SIGNING_KEY_FILE: ${{ env.SIGNING_KEY_FILE_PATH }}
+
+      - run: echo "Build status report=${{ job.status }}."

.github/workflows/lint.yml

@@ -0,0 +1,32 @@
+name: Lint
+on: [pull_request, workflow_dispatch, workflow_call]
+
+concurrency:
+  group: lint-${{ github.event.number }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Run Lint
+        run: ./gradlew ktLint
+        continue-on-error: true
+
+      - name: Get Lint Reports
+        uses: yutailang0119/action-ktlint@v3
+        with:
+          report-path: build/reports/ktlint/*.xml
+        continue-on-error: false

.github/workflows/release-snapshots.yml

@@ -0,0 +1,70 @@
+name: Snapshot Release
+on:
+  workflow_dispatch: {}
+env:
+  SIGNING_KEY_FILE_PATH: /home/runner/secretKey.gpg
+
+jobs:
+  lint:
+    uses: ./.github/workflows/lint.yml
+
+  test:
+    uses: ./.github/workflows/release-test.yml
+
+  build:
+    uses: ./.github/workflows/build.yml
+    secrets:
+      SIGNING_KEY_FILE: ${{ secrets.SIGNING_KEY_FILE }}
+      SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+      SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}
+
+  # after build and unit tests are finished, publish all modules at once
+  # to help reduce the probability of failure when interacting with sonatype servers
+  release:
+    name: Snapshot Release
+    needs: [lint, test, build]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+        with:
+          # pulls all commits (needed for semantic release to correctly version)
+          fetch-depth: '0'
+          persist-credentials: false
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+
+      - name: Decode Signing Key
+        uses: ./.github/actions/decode_signing_key_action
+        with:
+          signing_key_file: ${{ secrets.SIGNING_KEY_FILE }}
+          signing_file_path: ${{ env.SIGNING_KEY_FILE_PATH }}
+
+      - name: Set snapshot environment variable
+        run: echo "USE_SNAPSHOT=true" >> $GITHUB_ENV
+
+      - name: Install Semantic Release Dependencies
+        run: npm install
+
+      - name: GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONATYPE_NEXUS_USERNAME: ${{ secrets.SONATYPE_NEXUS_USERNAME }}
+          SONATYPE_NEXUS_PASSWORD: ${{ secrets.SONATYPE_NEXUS_PASSWORD }}
+          SIGNING_KEY_ID: ${{ secrets.SIGNING_KEY_ID }}
+          SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}
+          SIGNING_KEY_FILE: ${{ env.SIGNING_KEY_FILE_PATH }}
+        run: npx semantic-release@21
+
+      - name: Publish to Maven
+        uses: ./.github/actions/publish_all_modules
+        with:
+          sonatype_user: ${{ secrets.SONATYPE_SDKS_NEXUS_USERNAME }}
+          sonatype_password: ${{ secrets.SONATYPE_SDKS_NEXUS_PASSWORD }}
+          signing_key_id: ${{ secrets.SIGNING_KEY_ID }}
+          signing_key_password: ${{ secrets.SIGNING_KEY_PASSWORD }}
+          signing_key_file: ${{ env.SIGNING_KEY_FILE_PATH }}

.github/workflows/release-test.yml

@@ -0,0 +1,68 @@
+name: Test Release
+on: [workflow_dispatch, workflow_call]
+
+concurrency:
+  group: test-${{ github.event.number }}
+  cancel-in-progress: true
+
+jobs:
+  test_unit:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Run Unit Tests
+        run: ./gradlew testReleaseUnitTest
+        continue-on-error: false
+
+  test_unit_coverage:
+    name: Unit Tests Coverage
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Run Unit Tests Coverage
+        run: ./gradlew koverXmlReportDebug
+
+  test_instrumentation:
+    name: Instrumentation Tests
+    runs-on: macos-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'microsoft'
+          cache: gradle
+
+      - name: Run Instrumentation Tests
+        uses: ReactiveCircus/android-emulator-runner@v2
+        with:
+          api-level: 23
+          target: google_apis
+          arch: x86_64
+          script: ./gradlew connectedCheck --info
+        continue-on-error: true