RetroDECK/.github/workflows/build_release.yml

name: "Build RetroDECK"

on:
  push:
    branches:
      - main
      - cooker*
      - feat*
      - branch/cooker*
    paths:
      - '.github/workflows/**'
      - 'automation_tools/**'
      - 'config/**'
      - 'functions/**'
      - 'rd-submodules/**'
      - '*.sh'
      - 'net.retrodeck.retrodeck.yml'
      - 'net.retrodeck.retrodeck.appdata.xml'
  pull_request:
    branches:
      - main
      - cooker*

  workflow_dispatch:

permissions:
  contents: write

jobs:

  # Build RetroDECK Job
  Build_RetroDECK:
    runs-on: retrodeck-server
    outputs:
      TAG: ${{ steps.version-tag.outputs.TAG }}
      RELEASE_BODY: ${{ steps.version-tag.outputs.RELEASE_BODY }}
      
    steps:
      # Remove Stuck Mounts
      - name: Remove stuck mounts
        run: |
          sudo umount -f /home/ubuntu/actions-runner/_work/RetroDECK/RetroDECK/.flatpak-builder/rofiles/*
          sudo umount -f $HOME/actions-run/_work/RetroDECK/RetroDECK/.flatpak-builder/rofiles/*
        continue-on-error: true

      # Clone Repository
      - name: Clone RetroDECK repo
        uses: actions/checkout@v4
        with:
          submodules: true

      # Install Dependencies
      - name: Install dependencies
        run: curl "https://raw.githubusercontent.com/RetroDECK/components-template/main/automation_tools/install_dependencies.sh" | bash

      # Generate Build ID for Cooker Branches
      - name: Generate cooker build ID
        if: github.ref != 'refs/heads/main'
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/cooker_build_id.sh"
        
      # Generates a version tag based on the event type (main branch, PR, or cooker) and sets it as output.
      - name: Generate Version Tag
        id: version-tag
        run: |
          # Source the version extractor script and fetch the manifest version
          source automation_tools/version_extractor.sh
          MANIFEST_VERSION="$(fetch_manifest_version)"

          # Ensure the manifest version was successfully extracted
          if [[ -z "$MANIFEST_VERSION" ]]; then
            echo "[ERROR] Failed to extract the manifest version."
            exit 1
          fi

          # Determine the tag based on the GitHub event context
          if [[ "$GITHUB_REF" == "refs/heads/main" ]]; then
            # Main branch tag
            TAG="$MANIFEST_VERSION"
            MAKE_LATEST=true
          elif [[ "$GITHUB_EVENT_NAME" == "pull_request" || "$GITHUB_EVENT_NAME" == "pull_request_target" ]]; then
            # Pull request tag, sanitize the source branch
            source_branch="${GITHUB_HEAD_REF//\//-}"
            TAG="PR-$source_branch-${{ github.run_id }}"
            MAKE_LATEST=false
          else
            # Other branches (cooker branches)
            TAG="$MANIFEST_VERSION-${{ env.BUILD_ID }}"
            MAKE_LATEST=true
          fi

          echo "TAG=$TAG" >> $GITHUB_ENV
          echo "MAKE_LATEST=$MAKE_LATEST" >> $GITHUB_ENV

      # backing up manifest in case download fails and hashes must be recalculated
      - name: Manifest backup
        run: "cp ${GITHUB_WORKSPACE}/net.retrodeck.retrodeck.yml ${GITHUB_WORKSPACE}/net.retrodeck.retrodeck.yml.bak"

      - name: Run pre-build automation tasks
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/pre_build_automation.sh"

      - name: "Adding flatpak portal for automated updates (Cooker only)"
        if: github.ref != 'refs/heads/main'
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/cooker_flatpak_portal_add.sh"

      - name: "Updating release notes in appdata"
        run: "automation_tools/appdata_management.sh"

      - name: "[DEBUG] Outputting manifest"
        run: cat net.retrodeck.retrodeck.yml

      # Get Commits Since Last Published Release (Cooker only)
      - name: Get commits since last published release
        id: get-commits
        if: github.ref != 'refs/heads/main'
        run: |
          # Get the latest published release tag
          LATEST_TAG=$(git describe --tags $(git rev-list --tags --max-count=1) 2>/dev/null || echo "")

          if [ -z "$LATEST_TAG" ]; then
            echo "[INFO] No previous release found. Using all commits."
            COMMITS=$(git log HEAD --pretty=format:"- %s")
          else
            echo "[INFO] Latest published release tag: $LATEST_TAG"
            COMMITS=$(git log ${LATEST_TAG}..HEAD --pretty=format:"- %s")
          fi

          # Debug: Print the commits list
          echo "Commits since $LATEST_TAG:"
          echo "$COMMITS"

          # Export the commits list to the GitHub environment
          echo "COMMITS=$COMMITS" >> $GITHUB_ENV


      # Generate Release Body
      - name: Generate release body text
        id: generate-body
        run: |
          # Initialize the release body text
          RELEASE_BODY="# Release Notes\n"
          RELEASE_BODY+="This is a cooker snapshot based on the commit: ${{ github.event.repository.full_name }}@${{github.sha}}."
          RELEASE_BODY+="On branch [${{env.BRANCH_NAME}}](https://repo.retrodeck.net/RetroDECK/RetroDECK/src/branch/${{env.BRANCH_NAME}})."
          RELEASE_BODY+="## Commits since last release\n"
          RELEASE_BODY+="$COMMITS\n\n"

          echo "[DEBUG] CHECKPOINT 1"

          xml_file="./net.retrodeck.retrodeck.appdata.xml"
          if [[ ! -f "$xml_file" ]]; then
            echo "Error: XML file not found: $xml_file"
            exit 1
          fi

          echo "[DEBUG] CHECKPOINT 2"

          # Extract the raw description content using xmlstarlet
          # Extract the raw description content using xmlstarlet with error handling
          raw_description=$(xmlstarlet sel -t -m "/component/releases/release[1]/description/*" -c "." -n "$xml_file" 2>&1)
          status=$?

          if [[ $status -ne 0 ]]; then
            echo "[ERROR] Failed to extract description content using xmlstarlet. Error output:"
            echo "$raw_description"
            exit 1
          fi

          echo "[DEBUG] CHECKPOINT 3"

          # Convert <p> tags to markdown headers using sed
          markdown_description=$(echo "$raw_description" | sed -e 's|<p>|\n### |g' -e 's|</p>||g')

          echo "[DEBUG] CHECKPOINT 4"

          # Convert <li> tags to bullet points and trim spaces
          markdown_description=$(echo "$markdown_description" | sed -e 's|<ul>||g' -e 's|</ul>||g' -e 's|<li>|- |g' -e 's|</li>||g' | awk '{$1=$1;print}')

          echo "[DEBUG] CHECKPOINT 5"

          # Remove any remaining XML tags
          markdown_description=$(echo "$markdown_description" | sed -e 's/<[^>]*>//g')

          echo "[DEBUG] CHECKPOINT 6"

          # Debug: Print the markdown description
          echo "Markdown Description:"
          echo "$markdown_description"

          echo "[DEBUG] CHECKPOINT 7"

          # Append markdown content to the release body
          RELEASE_BODY+="$markdown_description"
          printf "RELEASE_BODY=%s\n" "$RELEASE_BODY" >> $GITHUB_ENV

          echo "[DEBUG] CHECKPOINT 8"

      - name: "Build flatpak: download only"
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/flatpak_build_download_only.sh"

      # Sometimes flatpak download fails, in this case it tries a second time
      - name: "Build flatpak: download only (retry)"
        if: steps.flatpak-download.outcome == 'failure'
        run: |
          echo "Download failed, maybe some hash changed since the build start."
          echo "Recalculating hashes and retrying download..."
          rm -f "{GITHUB_WORKSPACE}/net.retrodeck.retrodeck.yml"
          cp "${GITHUB_WORKSPACE}/net.retrodeck.retrodeck.yml.bak" "${GITHUB_WORKSPACE}/net.retrodeck.retrodeck.yml"
          "${GITHUB_WORKSPACE}/automation_tools/pre_build_automation.sh"
          "${GITHUB_WORKSPACE}/automation_tools/flatpak_build_download_only.sh"

      - name: Build flatpak
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/flatpak_build_only.sh"

      - name: Create Bundle
        run: "/bin/bash ${GITHUB_WORKSPACE}/automation_tools/flatpak_build_bundle.sh"

      # Upload artifacts for other jobs
      - name: Upload Build Artifacts
        uses: actions/upload-artifact@v4
        with:
          name: retrodeck-artifacts
          path: |
            RetroDECK*.flatpak
            RetroDECK*.flatpak.sha
            RetroDECK*Artifact.tar.gz

  GitHub-publish:
    runs-on: ubuntu-latest
    needs: Build_RetroDECK
    env:
      TAG: ${{ needs.Build_RetroDECK.outputs.TAG }}
      RELEASE_BODY: ${{ needs.Build_RetroDECK.outputs.RELEASE_BODY }}
      MAKE_LATEST: ${{ needs.Build_RetroDECK.outputs.MAKE_LATEST }}
    steps:

      - name: Generate a token for Rekku
        if: ${{ github.repository == 'RetroDECK/RetroDECK' }}
        id: generate-rekku-token
        uses: actions/create-github-app-token@v1
        with:
          app-id: ${{ vars.REKKU_APP_ID }}
          private-key: ${{ secrets.REKKU_PRIVATE_KEY }}
          repositories: "RetroDECK,Cooker"
          owner: "RetroDECK"

      # Determine if Target Repository is Main or not, in that case is a Cooker build
      - name: Determine target repository
        id: set-repo
        run: |
          if [[ "$GITHUB_REF" == "refs/heads/main" ]]; then
            echo "REPO_NAME=RetroDECK" >> $GITHUB_ENV
          else
            echo "REPO_NAME=Cooker" >> $GITHUB_ENV
          fi

      # Publish Release
      - name: Publish release
        uses: ncipollo/release-action@v1
        with:
          tag: ${{ env.TAG }}
          name: "RetroDECK ${{ env.TAG }}"
          body: ${{ env.RELEASE_BODY }}
          artifacts: "*.flatpak,*.flatpak.sha,*Artifact.tar.gz"
          allowUpdates: true
          makeLatest: ${{ env.MAKE_LATEST }}

      # Rewrite Tag (for Main Branch Only)
      - name: Rewrite Tag
        if: github.ref == 'refs/heads/main'
        run: |
          git submodule deinit -f --all
          git fetch --tags
          if git rev-parse --verify "${{ env.TAG }}" >/dev/null 2>&1; then
              git tag -d "${{ env.TAG }}"
              git push --delete origin "${{ env.TAG }}"
          fi
          git tag "${{ env.TAG }}"
          git push origin "${{ env.TAG }}"
        env:
          GITHUB_TOKEN: ${{ steps.generate-rekku-token.outputs.token }}

  # As backup we're even publishing the build on our own selfhosted Fogejo instance
  # Forgejo Publish Job if main branch
  # Forgejo-publish:
  #   if: github.ref == 'refs/heads/main'
  #   needs: Build_RetroDECK
  #   uses: RetroDECK/components-template/.github/workflows/fogejo_publish_release.yml@main
  #   with:
  #     release_body: ${{ env.RELEASE_BODY }}
  #     artifacts: "*.flatpak,*.flatpak.sha,*Artifact.tar.gz"
  #     tag: ${{ env.TAG }}
  #   secrets: 
  #     FORGEJO_TRIGGER_BUILD_TOKEN: ${{ secrets.FORGEJO_TRIGGER_BUILD_TOKEN }}