xgj/cache-state/examples/basic-usage.yml

# 基础使用示例
# 演示如何使用 cache-state action 进行基本的状态管理

name: Cache State - 基础使用示例

on:
  workflow_dispatch:
    inputs:
      version:
        description: '要设置的版本号'
        required: false
        default: 'v1.0.0'

jobs:
  demo-basic-usage:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码
        uses: actions/checkout@v4

      - name: 获取或设置应用版本
        id: app-version
        uses: .actions/xgj/cache-state@v1
        with:
          state-key: 'application-version'
          state-value: ${{ github.event.inputs.version }}
          default-value: 'v0.1.0'
          action: 'get-or-set'

      - name: 显示版本信息
        run: |
          echo "🏷️ 应用版本: ${{ steps.app-version.outputs.state-value }}"
          echo "💾 缓存命中: ${{ steps.app-version.outputs.cache-hit }}"
          echo "🔄 使用默认值: ${{ steps.app-version.outputs.used-default }}"
          echo "🔑 缓存键: ${{ steps.app-version.outputs.cache-key }}"

      - name: 基于版本信息的条件操作
        run: |
          if [[ "${{ steps.app-version.outputs.used-default }}" == "true" ]]; then
            echo "⚠️ 使用了默认版本，可能是首次运行"
            echo "执行初始化操作..."
          else
            echo "✅ 使用了已有版本或新设置的版本"
            echo "执行常规操作..."
          fi

      - name: 记录构建状态
        uses: .actions/xgj/cache-state@v1
        with:
          state-key: 'last-build-status'
          state-value: 'success'
          action: 'set'

      - name: 获取构建历史
        id: build-history
        uses: .actions/xgj/cache-state@v1
        with:
          state-key: 'build-count'
          state-value: '1'
          default-value: '0'
          action: 'get-or-set'

      - name: 更新构建计数
        run: |
          CURRENT_COUNT=${{ steps.build-history.outputs.state-value }}
          NEW_COUNT=$((CURRENT_COUNT + 1))
          echo "当前构建次数: ${CURRENT_COUNT}"
          echo "新的构建次数: ${NEW_COUNT}"

      - name: 保存新的构建计数
        uses: .actions/xgj/cache-state@v1
        with:
          state-key: 'build-count'
          state-value: ${{ env.NEW_COUNT }}
          action: 'set'
        env:
          NEW_COUNT: ${{ steps.build-history.outputs.state-value == '0' && '1' || format('{0}', steps.build-history.outputs.state-value + 1) }}