From 26b7bf9a9e9290a6bd5416c12891afba054ba59c Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 14:07:42 +0500 Subject: [PATCH 1/7] Update deploy_docs.yml to include framework setup steps --- .github/workflows/deploy_docs.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index 417e78f..5e9e3f8 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -52,9 +52,15 @@ jobs: path: xcframework-to-docc - name: Setup Xcode Project 🛠️ run: | + set -x sh -e xcframework-to-docc/dl_framework.sh ${{ env.PACKAGE_NAME }} + echo "✅ Framework downloaded" + sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc + echo "✅ Header files moved" + sh -e xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder + echo "✅ Headers added to Xcode project" - name: Clone Python Script 👭 uses: actions/checkout@v3 with: From 45efaecbffb24b7f590ad95cf43c1cea0036d269 Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 14:52:32 +0500 Subject: [PATCH 2/7] Enhance deploy_docs workflow with error handling Updated shell script execution to include verbose output and error handling. --- .github/workflows/deploy_docs.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index 5e9e3f8..f76425c 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -56,11 +56,11 @@ jobs: sh -e xcframework-to-docc/dl_framework.sh ${{ env.PACKAGE_NAME }} echo "✅ Framework downloaded" - sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc + sh -v xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc || { echo "❌ move_header_files.sh failed"; cat xcframework-to-docc/move_header_files.sh; exit 1; } echo "✅ Header files moved" - sh -e xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder - echo "✅ Headers added to Xcode project" + sh -v xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder || { echo "❌ headers_to_xcodeproj.sh failed"; exit 1; } + echo "✅ Headers added to Xcode project" - name: Clone Python Script 👭 uses: actions/checkout@v3 with: From 2645b56f1c1354a093916f5a6cf7f125cc977456 Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 15:18:24 +0500 Subject: [PATCH 3/7] Refactor script execution to ignore errors Updated error handling for script executions in the deploy_docs workflow. --- .github/workflows/deploy_docs.yml | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index f76425c..38ced88 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -51,16 +51,26 @@ jobs: repository: maxxfrazer/xcframework-to-docc path: xcframework-to-docc - name: Setup Xcode Project 🛠️ + continue-on-error: true run: | set -x sh -e xcframework-to-docc/dl_framework.sh ${{ env.PACKAGE_NAME }} echo "✅ Framework downloaded" - sh -v xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc || { echo "❌ move_header_files.sh failed"; cat xcframework-to-docc/move_header_files.sh; exit 1; } + sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc echo "✅ Header files moved" - sh -v xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder || { echo "❌ headers_to_xcodeproj.sh failed"; exit 1; } - echo "✅ Headers added to Xcode project" + sh -e xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder + echo "✅ Headers added to Xcode project" + + - name: Debug - Show directory structure + run: | + echo "=== docc_builder structure ===" + find docc_builder -type f -name "*.h" | head -20 + echo "=== Looking for AgoraRtcKit.h ===" + find . -name "AgoraRtcKit.h" 2>/dev/null + echo "=== Full docc_builder directory listing ===" + ls -la docc_builder/ - name: Clone Python Script 👭 uses: actions/checkout@v3 with: From fe24778fbadd5b0170e133ce7060103e910aeb88 Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 15:26:55 +0500 Subject: [PATCH 4/7] Update workflow_deploy.yml --- .github/workflows/workflow_deploy.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/workflow_deploy.yml b/.github/workflows/workflow_deploy.yml index a006e16..b7f7175 100644 --- a/.github/workflows/workflow_deploy.yml +++ b/.github/workflows/workflow_deploy.yml @@ -25,7 +25,7 @@ env: jobs: generate-docc: name: Build DocC Archives - runs-on: macos-13 + runs-on: macOS-latest steps: - name: Checkout 🛎️ uses: actions/checkout@v3 From 39c241de5b6e4a430a304146bd07c28a502b30e2 Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 15:31:16 +0500 Subject: [PATCH 5/7] Refactor deploy_docs.yml to streamline setup process Removed debug steps and added structure checks for framework and docc_builder. --- .github/workflows/deploy_docs.yml | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index 38ced88..2d6b5e3 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -51,26 +51,27 @@ jobs: repository: maxxfrazer/xcframework-to-docc path: xcframework-to-docc - name: Setup Xcode Project 🛠️ - continue-on-error: true run: | set -x sh -e xcframework-to-docc/dl_framework.sh ${{ env.PACKAGE_NAME }} echo "✅ Framework downloaded" + echo "=== Checking framework structure ===" + find AgoraRtcKit.xcframework -name "AgoraRtcKit.h" | head -5 + find AgoraRtcKit.xcframework -type d -name Headers + sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc echo "✅ Header files moved" + echo "=== Checking docc_builder after move ===" + ls -la docc_builder/ + find docc_builder -name "AgoraRtcKit.h" 2>/dev/null || echo "❌ AgoraRtcKit.h not found in docc_builder" + sh -e xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder echo "✅ Headers added to Xcode project" - - - name: Debug - Show directory structure - run: | - echo "=== docc_builder structure ===" - find docc_builder -type f -name "*.h" | head -20 - echo "=== Looking for AgoraRtcKit.h ===" - find . -name "AgoraRtcKit.h" 2>/dev/null - echo "=== Full docc_builder directory listing ===" - ls -la docc_builder/ + + echo "=== Final docc_builder structure ===" + ls -la docc_builder/AgoraRtcKit/Headers/ 2>/dev/null || echo "docc_builder/AgoraRtcKit/Headers/ doesn't exist" - name: Clone Python Script 👭 uses: actions/checkout@v3 with: From e006d331d0f32ae36855c7240ffadd6a7ddeae5f Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 15:37:25 +0500 Subject: [PATCH 6/7] Refactor deploy_docs.yml for efficiency Updated the deployment workflow to streamline header file movement and removed unnecessary checks. --- .github/workflows/deploy_docs.yml | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index 2d6b5e3..3528efb 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -52,26 +52,14 @@ jobs: path: xcframework-to-docc - name: Setup Xcode Project 🛠️ run: | - set -x sh -e xcframework-to-docc/dl_framework.sh ${{ env.PACKAGE_NAME }} echo "✅ Framework downloaded" - echo "=== Checking framework structure ===" - find AgoraRtcKit.xcframework -name "AgoraRtcKit.h" | head -5 - find AgoraRtcKit.xcframework -type d -name Headers - - sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc + sh -e xcframework-to-docc/move_header_files.sh ${{ env.PACKAGE_NAME }}.xcframework ${{ env.PACKAGE_NAME }}.docc ios-arm64 echo "✅ Header files moved" - echo "=== Checking docc_builder after move ===" - ls -la docc_builder/ - find docc_builder -name "AgoraRtcKit.h" 2>/dev/null || echo "❌ AgoraRtcKit.h not found in docc_builder" - sh -e xcframework-to-docc/headers_to_xcodeproj.sh ${{ env.PACKAGE_NAME }} docc_builder echo "✅ Headers added to Xcode project" - - echo "=== Final docc_builder structure ===" - ls -la docc_builder/AgoraRtcKit/Headers/ 2>/dev/null || echo "docc_builder/AgoraRtcKit/Headers/ doesn't exist" - name: Clone Python Script 👭 uses: actions/checkout@v3 with: From 5062b48858374facf11952af7efac33529ea5869 Mon Sep 17 00:00:00 2001 From: Saud <65331551+saudsami@users.noreply.github.com> Date: Mon, 19 Jan 2026 15:54:05 +0500 Subject: [PATCH 7/7] Upgrade download-artifact action to v4 --- .github/workflows/deploy_docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml index 3528efb..5647b11 100644 --- a/.github/workflows/deploy_docs.yml +++ b/.github/workflows/deploy_docs.yml @@ -111,7 +111,7 @@ jobs: language: ['en'] steps: - name: Download DocC Archive ⬇️ - uses: actions/download-artifact@v3 + uses: actions/download-artifact@v4 with: name: ${{ env.PACKAGE_NAME }}-${{ matrix.language }}.doccarchive.zip - name: Unzip Archive 😮