docs.yml

name: Javadocs

on:
  push:
    branches:
      - main

jobs:
  gen-javadocs:
    name: Javadocs
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-java@v3
        with:
          java-version: |
            17
            11
          distribution: "temurin"
          cache: "maven"
      - name: Build Javadocs
        run: mvn javadoc:aggregate -Dmaven.javadoc.skippedModules=ngrok-java-native
      - name: Archive Javadoc site
        run: tar --directory target/site/apidocs -cvf "$RUNNER_TEMP/artifact.tar" .
      - name: Upload Archive
        uses: actions/upload-artifact@v1
        with:
          name: github-pages
          path: ${{ runner.temp }}/artifact.tar
          retention-days: ${{ inputs.retention-days }}

  deploy:
    needs: gen-javadocs
    runs-on: ubuntu-latest

    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
    permissions:
      pages: write # to deploy to Pages
      id-token: write # to verify the deployment originates from an appropriate source

    # Deploy to the github-pages environment
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v1