docs.yml

on:
  pull_request:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      deployments: write
      id-token: write
    steps:
      - uses: actions/checkout@v3

      # Gradle 7 requires Java 11 to run
      - uses: actions/setup-java@v3
        with:
          distribution: zulu
          java-version: '19'

      - name: Build Documentation
        run: |
          ./gradlew dokkaHtmlMultiModule --stacktrace -PruntimeSecrets=USE_DUMMY_EMPTY_STRING_VALUES
          ls -al build/dokka/htmlMultiModule
        env:
          ORG_GRADLE_PROJECT_MAPBOX_DOWNLOADS_TOKEN: ${{ secrets.MAPBOX_DOWNLOADS_TOKEN }}

      - name: Configure AWS Credentials
        # at some point AWS will release a `v2` of this action. See:
        # https://github.com/aws-actions/configure-aws-credentials/issues/489#issuecomment-1278145876
        uses: aws-actions/configure-aws-credentials@v1-node16
        with:
          aws-region: eu-west-2
          role-to-assume: arn:aws:iam::${{ secrets.ABLY_AWS_ACCOUNT_ID_SDK}}:role/ably-sdk-builds-ably-asset-tracking-android
          role-session-name: "${{ github.run_id }}-${{ github.run_number }}"

      - uses: ably/sdk-upload-action@v2
        with:
          sourcePath: build/dokka/htmlMultiModule
          githubToken: ${{ secrets.GITHUB_TOKEN }}
          artifactName: dokka