Initial commit - v1.1.9
This commit is contained in:
143
.agent/workflows/GIT_PUSH_GUIDE.md
Normal file
143
.agent/workflows/GIT_PUSH_GUIDE.md
Normal file
@@ -0,0 +1,143 @@
|
||||
# Git 푸시 성공 가이드
|
||||
|
||||
## 빠른 실행
|
||||
|
||||
```bash
|
||||
# 1. gh CLI 인증 확인
|
||||
./gh.exe auth status
|
||||
|
||||
# 2. 인증이 안 되어 있으면 로그인
|
||||
./gh.exe auth login --web
|
||||
|
||||
# 3. Git에 gh 인증 설정
|
||||
./gh.exe auth setup-git
|
||||
|
||||
# 4. 푸시
|
||||
git push shiftring main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 상세 절차
|
||||
|
||||
### 1. GitHub CLI 인증
|
||||
|
||||
```bash
|
||||
# 인증 상태 확인
|
||||
./gh.exe auth status
|
||||
```
|
||||
|
||||
**인증이 안 된 경우:**
|
||||
```bash
|
||||
./gh.exe auth login --web
|
||||
```
|
||||
- One-time code가 표시됨 (예: C7EF-30B3)
|
||||
- https://github.com/login/device 접속
|
||||
- 코드 입력 후 인증 완료
|
||||
|
||||
### 2. Git에 gh 인증 연동
|
||||
|
||||
```bash
|
||||
./gh.exe auth setup-git
|
||||
```
|
||||
|
||||
### 3. 푸시 실행
|
||||
|
||||
```bash
|
||||
# shiftring remote 사용 (agent.md에 정의됨)
|
||||
git push shiftring main
|
||||
|
||||
# 또는 origin 사용
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 저장소 정보
|
||||
|
||||
| Remote | URL | 용도 |
|
||||
|--------|-----|------|
|
||||
| origin | https://github.com/sanjeok77-tech/ShiftRing.git | 코드 저장소 |
|
||||
| shiftring | https://github.com/sanjeok77-tech/ShiftRing.git | 코드 저장소 (동일) |
|
||||
|
||||
---
|
||||
|
||||
## 문제 해결
|
||||
|
||||
### "Cannot prompt because user interactivity has been disabled"
|
||||
|
||||
**원인**: 환경 변수로 인해 인터랙티브 프롬프트가 비활성화됨
|
||||
|
||||
**해결**:
|
||||
```bash
|
||||
# gh CLI로 인증 설정
|
||||
./gh.exe auth setup-git
|
||||
|
||||
# 그 다음 푸시
|
||||
git push shiftring main
|
||||
```
|
||||
|
||||
### "Host key verification failed" (SSH)
|
||||
|
||||
**원인**: SSH 키가 설정되지 않음
|
||||
|
||||
**해결**: HTTPS 사용
|
||||
```bash
|
||||
git remote set-url origin https://github.com/sanjeok77-tech/ShiftRing.git
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 릴리즈 푸시 (dakjaba-releases)
|
||||
|
||||
```bash
|
||||
# 1. 버전 파일 업데이트
|
||||
# version.json, CHANGELOG.md, README.md 수정
|
||||
|
||||
# 2. APK 복사
|
||||
cp app/build/outputs/apk/release/app-release.apk app.apk
|
||||
|
||||
# 3. GitHub Release 생성
|
||||
./gh.exe release create v1.1.4 "app.apk" \
|
||||
--title "Shiftring v1.1.4" \
|
||||
--notes "릴리즈 노트" \
|
||||
-R "sanjeok77-tech/dakjaba-releases"
|
||||
|
||||
# 4. dakjaba-releases 저장소 업데이트
|
||||
./gh.exe repo clone sanjeok77-tech/dakjaba-releases ../dakjaba-releases-temp
|
||||
cp version.json ../dakjaba-releases-temp/
|
||||
cp app.apk ../dakjaba-releases-temp/
|
||||
cd ../dakjaba-releases-temp
|
||||
git add . && git commit -m "update: vX.X.X" && git push origin main
|
||||
cd ..
|
||||
rm -rf dakjaba-releases-temp
|
||||
|
||||
# 5. 소스 코드 커밋 및 푸시
|
||||
cd /c/Users/work/Desktop/1.0.0
|
||||
git add . && git commit -m "chore: release vX.X.X"
|
||||
git push shiftring main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 성공 사례 (2026-02-21)
|
||||
|
||||
```bash
|
||||
$ ./gh.exe auth status
|
||||
github.com
|
||||
✓ Logged in to github.com account sanjeok77-tech (keyring)
|
||||
- Active account: true
|
||||
- Git operations protocol: https
|
||||
- Token: gho_************************************
|
||||
|
||||
$ ./gh.exe auth setup-git
|
||||
git: authorization completed
|
||||
|
||||
$ git push shiftring main
|
||||
To https://github.com/sanjeok77-tech/ShiftRing.git
|
||||
a848cd8..c72db7f main -> main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**최종 수정**: 2026-02-21
|
||||
70
.agent/workflows/push.md
Normal file
70
.agent/workflows/push.md
Normal file
@@ -0,0 +1,70 @@
|
||||
---
|
||||
description: 릴리즈 빌드 및 배포 자동화 가이드 (GitHub CLI 기반)
|
||||
---
|
||||
|
||||
# 🚀 릴리즈 빌드 및 배포 워크플로우
|
||||
|
||||
이 가이드는 교대링(Shiftring) 프로젝트의 최신 버전을 빌드하고, APK를 배포 저장소(`dakjaba-releases`)에 업로드하며, 버전을 갱신하는 절차를 설명합니다.
|
||||
|
||||
## // turbo-all
|
||||
## 1. 전제 조건
|
||||
- **GitHub CLI (gh)**가 설치되어 있고 로그인되어 있어야 함 (`gh auth status`)
|
||||
- `release.jks`와 `keystore.properties`가 루트 폴더에 존재해야 함
|
||||
|
||||
## 2. 배포 단계
|
||||
|
||||
### 단계 1: 프로젝트 버전 확인 및 갱신
|
||||
- `app/build.gradle.kts`의 `versionCode`와 `versionName`을 확인 및 갱신합니다.
|
||||
- `version.json`의 정보를 동일하게 맞춥니다.
|
||||
- `CHANGELOG.md`에 변경 사항을 기록합니다.
|
||||
- `README.md`의 다운로드 링크 및 버전을 갱신합니다.
|
||||
|
||||
### 단계 2: 릴리즈 빌드 수행
|
||||
```powershell
|
||||
./gradlew.bat assembleRelease
|
||||
```
|
||||
- 빌드 결과물은 `app/build/outputs/apk/release/app-release.apk`에 생성됩니다.
|
||||
|
||||
### 단계 3: APK 서명 확인 (선택 사항)
|
||||
- 생성된 APK가 정상적으로 서명되었는지 확인합니다.
|
||||
|
||||
### 단계 4: 배포 저장소 업데이트 및 릴리즈 생성
|
||||
// turbo
|
||||
```powershell
|
||||
# 1. APK 파일 복사 (배포용 이름으로 변경)
|
||||
copy-item "app/build/outputs/apk/release/app-release.apk" "app.apk" -Force
|
||||
|
||||
# 2. 버전 정보 설정 (현재 버전에 맞춰 수정)
|
||||
$VERSION = "v1.0.4"
|
||||
|
||||
# 3. GitHub Release 생성 (dakjaba-releases 저장소)
|
||||
# tip: 이미 존재하는 태그라면 삭제 후 생성하거나 gh release edit 사용
|
||||
gh release create $VERSION "app.apk" --title "Shiftring $VERSION" --notes-file "CHANGELOG.md" -R "sanjeok77-tech/dakjaba-releases"
|
||||
|
||||
# 4. 배포 저장소(dakjaba-releases)의 version.json 및 최신 APK 갱신 (인앱 업데이트용)
|
||||
gh repo clone sanjeok77-tech/dakjaba-releases ..\dakjaba-releases-temp
|
||||
copy-item "version.json" "..\dakjaba-releases-temp\version.json" -Force
|
||||
copy-item "app.apk" "..\dakjaba-releases-temp\app.apk" -Force
|
||||
|
||||
# 5. README.md 자동 업데이트 (v1.1.1 패턴 기반 교체 예시 - 실제 버전변수로 대체 필요)
|
||||
# tip: sed나 powershell replace를 사용하여 README의 vX.X.X 및 다운로드 링크를 갱신합니다.
|
||||
(Get-Content README.md) -replace 'v\d+\.\d+\.\d+', "$VERSION" | Set-Content README.md
|
||||
(Get-Content ..\dakjaba-releases-temp\README.md) -replace 'v\d+\.\d+\.\d+', "$VERSION" | Set-Content ..\dakjaba-releases-temp\README.md
|
||||
|
||||
pushd ..\dakjaba-releases-temp
|
||||
git add .
|
||||
git commit -m "update: $VERSION"
|
||||
git push origin main
|
||||
popd
|
||||
Remove-Item -Recurse -Force ..\dakjaba-releases-temp
|
||||
```
|
||||
|
||||
### 단계 5: 소스 코드 커밋 및 푸시
|
||||
```powershell
|
||||
git add .
|
||||
git commit -m "chore: release $VERSION"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
*주의: 배포 저장소(`dakjaba-releases`)는 퍼블릭이며, 코드 저장소(`dakjaba`)는 프라이빗입니다. 배포 시 중요한 키 파일이 배포 저장소에 포함되지 않도록 주의하십시오.*
|
||||
Reference in New Issue
Block a user