본문으로 건너뛰기
cccskills
무료GitHub에 공개

release-builds

Run post-merge release build steps for this repository, including Android tag-driven releases and sequential iOS IPA generation with archival for Transporter upload and Crashlytics deobfuscation. Use after the release PR has been merged.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template
연동 도구Firebase
설치 방법 보기

포함된 파일(2)

  • SKILL.md4.6 KB
  • scripts/archive_ios_ipa.sh1.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Flutter Template Release Builds

Use this skill only after the release PR has been merged.

Read First

  • AGENTS.md
  • docs/PROJECT_GUIDELINES.md
  • README.md
  • pubspec.yaml
  • makefile
  • .github/workflows/
  • .agents/skills/release-builds/scripts/archive_ios_ipa.sh

Goal

This skill is for the post-merge release-build phase.

It covers:

  • Android release triggering by tags
  • iOS IPA generation
  • archiving IPA files outside the cleaned build folder for Transporter upload
  • archiving Flutter obfuscation symbols from build/app/outputs/symbols for Crashlytics Dart stack-trace deobfuscation

Android Release Flow

Android releases are triggered by tags after the release branch work is merged.

Current workflow tag patterns:

  • develop Firebase distribution: v<version>-develop
  • staging Firebase distribution: v<version>-staging
  • production Firebase distribution: v<version>-production
  • Play Store production: v<version>-release

Before tagging:

  1. Confirm the merged commit and intended channel.
  2. Confirm the tag pattern matches the target workflow.
  3. Create the tag on the correct merged commit.
  4. Push the tag and monitor the corresponding GitHub Action.

iOS Release Flow

iOS release builds are manual and should be done one flavor at a time.

Why:

  • each make target runs make clean
  • each build clears the build/ directory
  • IPA files and Flutter obfuscation symbols must be copied out of build/ before the next build if you want to keep all generated artifacts

iOS Build Commands

  • develop:
    • make generateIosDevelopIpa
  • staging:
    • make generateIosStagingIpa
  • production:
    • make generateIosProductionIpa

iOS Artifact Archival Workflow

Immediately after each IPA build, archive the IPA out of build/ios/ipa/ and Flutter obfuscation symbols out of build/app/outputs/symbols before starting the next build.

Use:

.agents/skills/release-builds/scripts/archive_ios_ipa.sh <flavor>

Examples:

  • .agents/skills/release-builds/scripts/archive_ios_ipa.sh develop
  • .agents/skills/release-builds/scripts/archive_ios_ipa.sh staging
  • .agents/skills/release-builds/scripts/archive_ios_ipa.sh production

The script copies the generated IPA into:

release_artifacts/ios-ipa/<version>/

and renames it to include the flavor plus the full pubspec.yaml version token, including the build number, so multiple release IPAs can coexist even when only the build number changes.

It also copies the Flutter obfuscation symbols into:

release_artifacts/flutter-symbols/<version>/<flavor>/

These are the --split-debug-info Dart symbol files used for Flutter Crashlytics deobfuscation. They are separate from iOS dSYMs and Android R8/ProGuard mapping.txt.

Recommended iOS Sequence

  1. Build one flavor.
  2. Archive the IPA and Flutter obfuscation symbols with the helper script.
  3. Build the next flavor.
  4. Archive that IPA and its symbols too.
  5. Repeat until all required IPA files are archived.
  6. After all IPA files are safely archived, upload them manually through Transporter.
  7. Keep the archived Flutter obfuscation symbols with the release artifacts for Crashlytics deobfuscation.

Watch Outs

  • Do not run multiple iOS make targets back-to-back without archiving.
  • Do not assume the last-built IPA still exists in build/ios/ipa/.
  • Do not assume the last-built Flutter obfuscation symbols still exist in build/app/outputs/symbols.
  • The archival helper expects exactly one IPA in build/ios/ipa/ and fails loudly if multiple files are present.
  • The archival helper also expects build/app/outputs/symbols to exist and contain at least one file.
  • Transporter is the handoff point to App Store Connect.
  • Android and iOS release flows are intentionally different in this repo.
  • Transporter delivery is currently a manual step in this workflow, not an automated repo-integrated step.

Completion Criteria

  • Android tags match the intended workflows
  • each iOS IPA is generated one-at-a-time
  • each iOS IPA is copied out of the build folder
  • each iOS build's Flutter obfuscation symbols are copied out of the build folder
  • archived IPA filenames include flavor and the full app version token
  • archived Flutter obfuscation symbols are grouped by version and flavor
  • the team has a clean handoff path into Transporter

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

build-verify

무료

Build/test/lint verification pass for this Flutter app — runs codegen, analyze, test, then iOS + Android native builds in parallel, then `dart format`. Does NOT commit anything; leaves the working tree dirty so the user can review and commit on demand. Used at the end of the prd → techspec → tasks → implement-tasks-sequence flow before `pr-review`, and can also be invoked manually when the user says "verify build", "run full verification", or "check everything".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

create-pr

무료

Create or update a GitHub PR for this Flutter repository using gh CLI. Verifies the work with build-verify and pr-review, generates an inline PR description, commits pending changes when approved, pushes, and opens or updates the PR. Supports stacked PRs by asking for the base branch when detection is ambiguous. Use when the user says "create PR", "open PR", "push PR", or wants to submit their work for review.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

feature-data-flow

무료

Build a full feature in this Flutter repository that includes backend or storage data flow: read API schema, create DTOs, map DTOs to entities, add Riverpod use cases, connect feature state, and render UI data. Use when a task goes beyond a screen and needs real data integration.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

feature-screen

무료

Create a new Flutter screen in this repository using the existing feature structure, AutoRoute setup, Riverpod state pattern, and code generation workflow. Use when adding a new page, route, stateful screen, or feature folder in this template.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

implement

무료

Implement a single Flutter task following this repository's Riverpod, Freezed, AutoRoute, DTO/entity, codegen, and verification conventions. Reads the task definition, PRD, and tech spec, then executes the implementation. When invoked standalone, verifies the change; when invoked by implement-tasks-sequence, writes code only and leaves verification to start-job/build-verify. Use when the user says "implement task X", "work on task X", or wants to execute a specific task from the task list.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

implement-tasks-sequence

무료

Orchestrates implementation of all tasks for a feature using an agent team. Respects task dependencies, runs tasks in correct order, parallelizes independent tasks. Does NOT build, run tests, or commit at any point — verification is delegated to the caller (typically `/start-job`, which runs `build-verify` and `pr-review uncommitted` afterwards). Use when the user says "implement all tasks", "run the task sequence", "implement the feature", or wants to execute multiple tasks from a task list end-to-end.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

strvcom/flutter-template242026년 6월 18일 업데이트

strvcom의 스킬 모두 보기

이 스킬의 문제 신고