ci: Fix documentation compilation commands

Author: stackotter

.github/actions/compile-docs/action.yml

@@ -21,6 +21,8 @@ runs:
     - name: Compile documentation (with SwiftPM)
       if: ${{ inputs.xcodebuild != true }} # Compare to constant to treat empty input as false
       run: |
+        set -ex
+        mkdir "$TARGET.doccarchive" && \
         swift package \
           --allow-writing-to-directory "$TARGET.doccarchive" \
           generate-documentation \
@@ -38,13 +40,17 @@ runs:
     - name: Compile documentation (with xcodebuild)
       if: ${{ inputs.xcodebuild == true }} # Compare to constant to treat empty input as false
       run: |
+        set -ex
         destination=""
         if [[ $DEVICE_TYPE == "Mac" ]] || [[ $DEVICE_TYPE == "" ]]; then
           destination="platform=OS X"
         else
           destination="id=$(xcrun simctl list devices $devicetype available | grep -v -- -- | tail -n 1 | grep -oE '[0-9A-F\-]{36}')"
         fi
-        xcodebuild -skipMacroValidation -scheme "$TARGET" -destination "$(destination)" docbuild | xcbeautify --renderer github-actions
+        echo "$DEVICE_TYPE"
+        echo "Building documentation for destination '$destination'"
+        xcodebuild -skipMacroValidation -scheme "$TARGET" -destination "$destination" -derivedDataPath data docbuild | xcbeautify --renderer github-actions
+        cp -R "data/Build/Products/Debug/$TARGET.doccarchive" "$TARGET.doccarchive"
       shell: bash
       env:
         TARGET: ${{ inputs.target }}

.github/workflows/build-test-and-docs.yml

@@ -55,7 +55,7 @@ jobs:
     runs-on: macos-14
     strategy:
       matrix:
-        devicetype:
+        device-type:
           - iPhone
           - iPad
           - TV
@@ -71,11 +71,11 @@ jobs:
     - name: Build
       run: |
         set -uo pipefail
-        devicetype=${{ matrix.devicetype }}
+        device_type=${{ matrix.device-type }}
         set +e
-        deviceid=$(xcrun simctl list devices $devicetype available | grep -v -- -- | tail -n 1 | grep -oE '[0-9A-F\-]{36}')
+        deviceid=$(xcrun simctl list devices $device_type available | grep -v -- -- | tail -n 1 | grep -oE '[0-9A-F\-]{36}')
         if [ $? -eq 0 ]; then
-          set -e
+          set -ex
           (
             buildtarget () {
               xcodebuild -skipMacroValidation -scheme "$1" -destination "id=$deviceid" build | xcbeautify --renderer github-actions
@@ -93,29 +93,29 @@ jobs:
             buildtarget NotesExample
             buildtarget PathsExample
 
-            if [ $devicetype != TV ]; then
+            if [ $device_type != TV ]; then
               # Slider is not implemented for tvOS
               buildtarget ControlsExample
               buildtarget RandomNumberGeneratorExample
             fi
 
-            if [ $devicetype = iPad ]; then
+            if [ $device_type = iPad ]; then
               # NavigationSplitView is only implemented for iPad
               buildtarget SplitExample
             fi
           )
         else
-          echo "No $devicetype simulators found" >&2
+          echo "No $device_type simulators found" >&2
         fi
 
     - name: Compile UIKitBackend docs
-      if: ${{ matrix.devicetype == 'iPhone' }}
+      if: ${{ matrix.device-type == 'iPhone' }}
       uses: ./.github/actions/compile-docs
       with:
         target: UIKitBackend
         upload: true
         xcodebuild: true
-        xcodebuild_destination: ${{ matrix.devicetype }}
+        xcodebuild-device-type: ${{ matrix.device-type }}
 
   windows:
     runs-on: windows-latest