플러터에서 애플리케이션의 빌드 버전을 설정하는 방법은 무엇인가요?

Q1: 플러터에서 애플리케이션 빌드 버전이란 무엇인가요?
A1: 빌드 버전은 앱의 현재 버전을 나타내는 숫자 또는 문자열로, 사용자가 앱을 업데이트할 때 버전 차이를 인식하는 데 사용됩니다. 일반적으로 '버전 이름(versionName)'과 '버전 코드(versionCode)'(Android), 또는 'CFBundleShortVersionString'과 'CFBundleVersion'(iOS)으로 나뉩니다.

---

Q2: 플러터에서 버전과 빌드 번호는 어디에서 설정하나요?
A2: 플러터 프로젝트의 `pubspec.yaml` 파일 내 `version` 필드에서 설정합니다. 예시:
```yaml
version: 1.0.0+1
```
여기서 `1.0.0`이 버전 이름이고 `1`이 빌드 번호입니다.

---

Q3: `pubspec.yaml`의 버전 형식은 어떻게 되나요?
A3: `version: x.y.z+buildNumber` 형식입니다.
- `x.y.z`: 주 버전, 부 버전, 수정 버전을 의미하며, 숫자 또는 점(.)으로 구분된 문자열입니다.
- `buildNumber`: 플러터 내에서 정수형 빌드 번호로 사용됩니다(예: 1, 2, 3).

---

Q4: `pubspec.yaml`의 버전이 Android와 iOS 각각에 어떻게 반영되나요?
A4:
- Android : `versionName`은 `x.y.z`(예: 1.0.0), `versionCode`는 `buildNumber` 값을 사용합니다.
- iOS : `CFBundleShortVersionString`은 `x.y.z` 값을, `CFBundleVersion`은 `buildNumber` 값을 사용합니다.

---

Q5: Android의 빌드 버전을 별도로 지정하려면 어떻게 하나요?
A5: 기본적으로 `pubspec.yaml`에서 관리하지만, 필요 시 `android/app/build.gradle` 파일 내에서 `versionCode`와 `versionName`을 직접 수정할 수 있습니다. 다만 Flutter는 `pubspec.yaml` 기준으로 덮어쓸 수 있으니 각별히 주의해야 합니다.

---
Q6: iOS 빌드 버전을 수동으로 수정하려면?
A6: `ios/Runner.xcodeproj/project.pbxproj` 또는 Xcode에서 직접 `General` 탭의 `Version`(CFBundleShortVersionString)과 `Build`(CFBundleVersion)를 변경할 수 있습니다. 하지만 Flutter 프로젝트 유지 관리를 위해 `pubspec.yaml`에서 관리하는 것이 권장됩니다.

---

Q7: 버전을 변경한 후 빌드하려면 어떻게 해야 하나요?
A7: `pubspec.yaml`에서 버전을 변경한 후, 다음 명령어로 빌드합니다.
- Android: `flutter build apk` 또는 `flutter build appbundle`
- iOS: `flutter build ios`

---

Q8: 버전을 확인하는 방법은?
A8: `flutter pub get` 후 앱 실행 시, 런타임에 `package_info_plus` 같은 플러그인을 사용해 `version`과 `buildNumber`를 확인할 수 있습니다.

---

요약:
- 플러터 앱 빌드 버전은 `pubspec.yaml`의 `version` 필드에서 `주.부.수정+빌드번호` 형식으로 설정
- Android와 iOS 빌드 설정에 자동으로 반영
- 필요시 플랫폼별 설정 파일에서 직접 수정 가능하지만, 일관성 유지를 위해 `pubspec.yaml` 권장
- 버전 변경 후 앱을 재빌드하여 적용

---

필요 시 예시:
```yaml
version: 2.1.0+5
```
- 버전 이름: 2.1.0
- 빌드 번호: 5

Flutter에서 애플리케이션의 빌드 버전을 설정하는 방법은 간단하지만, 몇 가지 중요한 단계를 포함합니다.

Flutter 애플리케이션의 버전 관리는 주로 `pubspec.yaml` 파일과 플랫폼별 설정 파일에서 이루어집니다.

아래에서 각 단계에 대해 자세히 설명하겠습니다.

1. `pubspec.yaml` 파일 수정 Flutter 프로젝트의 루트 디렉토리에 위치한 `pubspec.yaml` 파일에서 애플리케이션의 버전 정보를 설정할 수 있습니다.

이 파일에서 `version` 필드를 찾아 수정합니다.

버전 정보는 다음과 같은 형식으로 지정됩니다: ``` version: x.y.z+build ``` - `x.y.z`는 주 버전, 부 버전, 패치 버전을 나타냅니다.

- `build`는 선택적이며, 빌드 번호를 나타냅니다.

이 값은 주로 앱의 빌드 버전을 관리하는 데 사용됩니다.

예를 들어, 다음과 같이 설정할 수 있습니다: ```yaml version: 1.0+.0+1 ``` 여기서 `1.0.0`은 애플리케이션의 버전 번호이고, `1`은 빌드 번호입니다.



2. Android 플랫폼 설정 Android 플랫폼에서 빌드 버전을 설정하려면 `android/app/build.gradle` 파일을 수정해야 합니다.

이 파일에서 `defaultConfig` 블록 내에 `versionCode`와 `versionName`을 설정합니다.

```groovy android { ... defaultConfig { ... versionCode 1 // 빌드 번호 versionName "1.0.0" // 버전 이름 } } ``` - `versionCode`는 정수형으로, 앱의 내부 버전 번호를 나타냅니다.

이 값은 앱의 업데이트 시 증가해야 합니다.

- `versionName`은 사용자에게 표시되는 버전 번호입니다.



3. iOS 플랫폼 설정 iOS 플랫폼에서 빌드 버전을 설정하려면 `ios/Runner.xcodeproj/project.pbxproj` 파일을 수정해야 합니다.

Xcode를 사용하여 이 파일을 열고, `CURRENT_PROJECT_VERSION`과 `MARKETING_VERSION`을 설정합니다.

- `CURRENT_PROJECT_VERSION`은 빌드 번호를 나타내며, 정수형으로 설정합니다.

- `MARKETING_VERSION`은 사용자에게 표시되는 버전 번호입니다.

Xcode에서 직접 수정하는 것이 가장 간편하며, 다음과 같은 값을 설정할 수 있습니다: ```plaintext MARKETING_VERSION = 1.0.0; CURRENT_PROJECT_VERSION = 1; ```

4. 버전 관리 및 배포 버전 관리는 애플리케이션의 업데이트 및 배포 과정에서 매우 중요합니다.

각 플랫폼에서 설정한 버전 번호는 앱 스토어에 제출할 때 사용됩니다.

따라서, 새로운 기능이나 버그 수정을 추가한 후에는 항상 버전 번호를 업데이트해야 합니다.



5. Flutter CLI를 통한 버전 업데이트 Flutter CLI를 사용하여 버전 번호를 쉽게 업데이트할 수도 있습니다.

다음 명령어를 사용하여 버전 번호를 업데이트할 수 있습니다: ```bash flutter pub version 1.0.1+2 ``` 이 명령어는 `pubspec.yaml` 파일의 버전 정보를 자동으로 업데이트합니다.

결론 Flutter 애플리케이션의 빌드 버전을 설정하는 것은 애플리케이션의 배포 및 관리에 있어 중요한 과정입니다.

`pubspec.yaml`, Android의 `build.gradle`, iOS의 Xcode 설정 파일을 통해 각각의 플랫폼에 맞게 버전 정보를 설정할 수 있습니다.

이러한 설정을 통해 사용자에게 명확한 버전 정보를 제공하고, 앱의 업데이트를 원활하게 관리할 수 있습니다.