versionName은 Android 애플리케이션의 버전을 사용자에게 보여주기 위한 문자열입니다. 주로 앱 설정화면, "앱 정보" 또는 앱 배포 페이지(예: Google Play) 등에서 사람이 읽을 수 있는 형태로 표시됩니다. 핵심 내용 - 용도: 사용자가 보는 버전 표기(예: "1.0.0", "2.1-beta") — 시스템이나 설치 비교 로직에는 사용되지 않습니다. - 시스템 비교: 업데이트 판단에는 사용되지 않음. 업데이트/업로드 비교는 정수인 versionCode(또는 Android App Bundle의 내부 메타데이터)를 사용합니다. - 위치(설정 방법): - AndroidManifest.xml:
- Gradle (권장): defaultConfig { versionName "1.0.0" } - 문자열 리소스를 참조할 수도 있음(android:versionName="@string/version_name") — 이 경우 로컬라이즈 가능. - 형식: 자유로운 문자열(숫자·문자·하이픈 등 가능). 관례적으로는 Semantic Versioning(예: MAJOR.MINOR.PATCH)나 빌드 태그를 사용하지만 반드시 따라야 하는 규칙은 없음. - 권장사항: 사용자가 이해하기 쉬운 형식으로 관리(예: "1.2.3", "2.0-beta"), 민감한 정보나 빌드 내부 경로 등 포함 금지. - 필수성: versionName는 권장되는 메타데이터지만, 앱 배포와 설치 업그레이드 판별을 위해 versionCode(또는 Play의 앱 번들 설정)는 필수적입니다. 요약: versionName은 내부 비교용이 아니라 사용자에게 보여주는 버전 문자열이며, 개발자는 사용자 친화적이고 일관된 표기법으로 관리하면 됩니다.
