← 전체로 돌아가기
공통 메모 android

Sync app versioning policy

Sync 앱 건드리면 무조건 버전 올려야 함.

androidversioningrelease

Sync 앱 변경 시 버전 규칙

/home/son/prj/log/android 경로 앱 수정할 때 적용.

version format: v[major].[minor].[patch]

  • patch: 코드, UI, 설정 등 배포 결과물 바뀌면 무조건 +1
  • minor/major: 기능 규모 클 때 올림. 이전 버전 재사용 금지.

Android build setting: versionName이랑 versionCode 둘 다 단조 증가시켜야 함.

APK 파일명: log-sync-v[version]-[build_type].apk 예: log-sync-v0.1.1-debug.apk

빌드 전 현재 버전 파일 직접 확인하고 다음 번호 계산해서 변경 후 빌드하면 끝.

여기서 배울 것

  1. 배포 결과물 바뀌면 patch 버전 무조건 올림
  2. versionName이랑 versionCode 세트로 관리
  3. APK 파일명에 버전 박아두기
원본 파일 보기 (.claude/memory/sync_app_versioning_policy.md)
---
name: Sync 앱 변경 시 버전 증가
description: log 프로젝트의 Android Sync 앱을 변경하거나 새 APK를 만들 때 적용할 버전 규칙
date: 2026-07-30
tags: [android, sync-app, versioning, release]
---

## 사용자 선호

`/home/son/prj/log/android`의 Sync 앱은 변경 사항이 생길 때마다 버전을 반드시 올린다.

## 적용 규칙

- 표시 버전은 `v0.1.0`, `v0.1.1`, `v0.1.2` 형식을 사용한다.
- 코드, 설정, UI, 동작 등 배포 결과에 영향을 주는 변경마다 최소 patch 숫자를 1 올린다.
- 기능 규모에 따라 minor/major를 올린 경우에도 이전 버전을 그대로 재사용하지 않는다.
- Android의 `versionName`과 함께 `versionCode`도 반드시 단조 증가시킨다.
- APK 파일명에도 버전을 넣는다. 예: `log-sync-v0.1.1-debug.apk`.
- 현재 버전은 파일을 직접 확인하고, 다음 버전 번호를 계산한 뒤 변경·빌드한다.