From 7fe8b0eb7442a252fc24b28e742fc25c08e0b4e2 Mon Sep 17 00:00:00 2001
From: hansoo <hansoo@ism.kr>
Date: Sun, 16 Mar 2025 20:35:32 +0900
Subject: [PATCH] create git branch for build app

---
 src/app-deployment-guide.md | 69 +++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/src/app-deployment-guide.md b/src/app-deployment-guide.md
index 73b3d5d..4e99351 100644
--- a/src/app-deployment-guide.md
+++ b/src/app-deployment-guide.md
@@ -59,6 +59,75 @@ npx cap open ios      # Xcode 열기 (Mac에서만 가능)
 - Xcode의 Assets.xcassets 내 AppIcon에 아이콘 설정
 - 다양한 크기 필요 (20pt~83.5pt, @1x, @2x, @3x)
 
+## Git 관리 가이드
+
+### Lovable에서 생성된 코드 관리하기
+
+#### 1. 로컬 변경사항 백업
+```bash
+# 현재 변경사항을 새 브랜치에 저장
+git checkout -b local-android-build
+git add .
+git commit -m "안드로이드 빌드 환경 설정 및 서버 URL 변경"
+```
+
+#### 2. 최신 코드 가져오기
+```bash
+# 메인 브랜치로 돌아가기
+git checkout main
+
+# 최신 코드 가져오기
+git pull
+```
+
+#### 3. 로컬 설정 적용하기
+```bash
+# 필요한 파일만 선택적으로 가져오기
+git checkout local-android-build -- capacitor.config.ts android/
+
+# 변경사항 커밋
+git commit -m "안드로이드 빌드 환경 설정 및 서버 URL 변경 적용"
+```
+
+#### 4. 앱 빌드하기
+```bash
+# 앱 동기화 및 빌드
+npx cap sync
+cd android && ./gradlew assembleDebug
+```
+
+### 주요 설정 파일 관리 팁
+
+1. **capacitor.config.ts**
+   - `server.url`: 앱이 연결할 서버 URL 설정
+   - `appId`: 앱 식별자 (스토어 등록 시 중요)
+
+2. **android/variables.gradle**
+   - SDK 버전 설정 (compileSdkVersion, targetSdkVersion)
+   - 라이브러리 버전 관리
+
+3. **android/build.gradle**
+   - Java 버전 호환성 설정
+   - 프로젝트 수준 종속성 관리
+
+4. **android/app/src/main/res/values/colors.xml**
+   - 앱 색상 테마 설정
+   - 중복 정의 피하기
+
+### Git 관리 모범 사례
+
+1. **로컬 설정 분리하기**
+   - 빌드 환경 설정은 별도 브랜치에 보관
+   - 핵심 설정만 메인 브랜치에 적용
+
+2. **충돌 해결 전략**
+   - 서버 URL 등 중요 설정은 로컬 값 유지
+   - 빌드 설정은 로컬 환경에 맞게 조정
+
+3. **변경사항 문서화**
+   - 중요 설정 변경 시 커밋 메시지에 명확히 기록
+   - 이 가이드 문서 지속적으로 업데이트
+
 ## 스토어 등록 정보 준비
 
 ### 공통 필요 자료