try manually...

Author: ktoso

.github/actions/install_swiftly/action.yml

@@ -0,0 +1,41 @@
+name: 'Swift Java CI Env'
+description: 'Prepare the CI environment by installing Swift and selected JDK etc.'
+
+runs:
+  using: composite
+  steps:
+    - name: Set up JDK ${{ matrix.jdk_version }}
+      uses: actions/setup-java@v4
+      with:
+        distribution: ${{ matrix.jdk_vendor }}
+        java-version: |
+          24
+          21
+          17
+        cache: 'gradle'
+    - name: Set JAVA_HOME_{N}
+      shell: bash
+      run: |
+        if [[ -n "$JAVA_HOME_21_X64" ]]; then
+          echo "JAVA_HOME_21=$JAVA_HOME_21_X64" >> $GITHUB_ENV
+        elif [[ -n "$JAVA_HOME_21_ARM64" ]]; then
+          echo "JAVA_HOME_21=$JAVA_HOME_21_ARM64" >> $GITHUB_ENV
+        fi
+        if [[ -n "$JAVA_HOME_24_X64" ]]; then
+          echo "JAVA_HOME_24=$JAVA_HOME_24_X64" >> $GITHUB_ENV
+        elif [[ -n "$JAVA_HOME_24_ARM64" ]]; then
+          echo "JAVA_HOME_24=$JAVA_HOME_24_ARM64" >> $GITHUB_ENV
+        fi
+      # - name: Check Java environment
+      #  shell: bash
+      #  run: ./gradlew -q javaToolchains
+    - name: Cache local SwiftPM repository
+      if: matrix.os_version == 'jammy'
+      uses: actions/cache@v4
+      continue-on-error: true
+      with:
+        path: /__w/swift-java/swift-java/.build/checkouts
+        key: ${{ runner.os }}-swiftpm-cache-${{ hashFiles('Package.swift') }}
+        restore-keys: |
+          ${{ runner.os }}-swiftpm-cache
+          ${{ runner.os }}-swiftpm-

.github/actions/prepare_env/action.yml

@@ -1,41 +1,9 @@
-name: 'Swift Java CI Env'
-description: 'Prepare the CI environment by installing Swift and selected JDK etc.'
+name: 'Install Swiftly'
+description: 'Install Swiftly'
 
 runs:
   using: composite
   steps:
-    - name: Set up JDK ${{ matrix.jdk_version }}
-      uses: actions/setup-java@v4
-      with:
-        distribution: ${{ matrix.jdk_vendor }}
-        java-version: |
-          24
-          21
-          17
-        cache: 'gradle'
-    - name: Set JAVA_HOME_{N}
+    - name: Set up Swiftly
       shell: bash
-      run: |
-        if [[ -n "$JAVA_HOME_21_X64" ]]; then
-          echo "JAVA_HOME_21=$JAVA_HOME_21_X64" >> $GITHUB_ENV
-        elif [[ -n "$JAVA_HOME_21_ARM64" ]]; then
-          echo "JAVA_HOME_21=$JAVA_HOME_21_ARM64" >> $GITHUB_ENV
-        fi
-        if [[ -n "$JAVA_HOME_24_X64" ]]; then
-          echo "JAVA_HOME_24=$JAVA_HOME_24_X64" >> $GITHUB_ENV
-        elif [[ -n "$JAVA_HOME_24_ARM64" ]]; then
-          echo "JAVA_HOME_24=$JAVA_HOME_24_ARM64" >> $GITHUB_ENV
-        fi
-      # - name: Check Java environment
-      #  shell: bash
-      #  run: ./gradlew -q javaToolchains
-    - name: Cache local SwiftPM repository
-      if: matrix.os_version == 'jammy'
-      uses: actions/cache@v4
-      continue-on-error: true
-      with:
-        path: /__w/swift-java/swift-java/.build/checkouts
-        key: ${{ runner.os }}-swiftpm-cache-${{ hashFiles('Package.swift') }}
-        restore-keys: |
-          ${{ runner.os }}-swiftpm-cache
-          ${{ runner.os }}-swiftpm-
+      run: ./.github/scripts/install_swiftly.sh

.github/scripts/install_swiftly.sh

@@ -84,5 +84,8 @@ echo "Displaying swift version"
 swiftly run "${runSelector[@]}" swift --version
 
 if [[ "$(uname -s)" == "Linux" ]]; then
-    CC=clang swiftly run "${runSelector[@]}" "$(dirname "$0")/install-libarchive.sh"
+    if [[ -f "$(dirname "$0")/install-libarchive.sh" ]]; then
+        CC=clang swiftly run "${runSelector[@]}" "$(dirname "$0")/install-libarchive.sh"
+    fi
 fi
+

.github/scripts/validate_docs.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+set -e
+set -x
+
+cat <<EOF >> Package.swift
+
+package.dependencies.append(
+  .package(url: "https://github.com/swiftlang/swift-docc-plugin", from: "1.0.0")
+)
+EOF
+
+echo "Active Swift:"
+which swift
+swift -version
+
+swift package plugin generate-documentation --target "SwiftJavaDocumentation" --warnings-as-errors --analyze

.github/workflows/pull_request.yml

@@ -26,21 +26,18 @@ jobs:
       fail-fast: true
       matrix:
         swift_version: ['6.1.2']
+        os_version: ['jammy']
         jdk_vendor: ['corretto']
     env:
       ADDITIONAL_DOCC_ARGUMENTS: ''
     steps:
       - uses: actions/checkout@v4
       - name: Prepare CI Environment
         uses: ./.github/actions/prepare_env
-      - name: Install Swiftly 
-        run: ./.github/scripts/install_swiftly.sh
-        env:
-          SWIFT_VERSION: "${{ matrix.swift_version }}"
+      - name: Install Swiftly / Swift ${{ matrix.swift_version }}
+        uses: ./.github/actions/install_swiftly
       - name: Run documentation check
-        run: |
-          which curl || (apt -q update && apt -yq install curl)
-          curl -s --retry 3 https://raw.githubusercontent.com/swiftlang/github-workflows/refs/heads/main/.github/workflows/scripts/check-docs.sh | bash
+        run: ./github/scripts/validate_docs.sh
 
   test-java:
     name: Test (Java) (${{ matrix.os_version }} swift:${{ matrix.swift_version }} jdk:${{matrix.jdk_vendor}})