(Flutter) 플러터 패키지명 변경하기 (라이브러리 사용방법 추가)

들어가며:

• 앱 개발 마지막 부분에 패키지명을 변경할 일이 많습니다. ((ex) com.example.패키지명 으로 했을 경우 google 앱스토어에 업로드가 안된다. )
• Flutter 에서 패키지명을 바꾸려면 어떤 부분을 바꿔야 하는지 또 한 라이브러리를 사용하면 얼마난 간편하게 패키지를 바꿀 수 있는지 알아보도록 하겠습니다.

본문:

1. Android:
   • /android/app/build.gradle 파일을 열어서 defaultConfig 섹션에 있는 applicationId를 새로운 패키지 이름으로 변경합니다.
   • /app/src/ 폴더 하위의 debug, main, profile 폴더에 있는 AndroidManifest.xml 파일들에서 <manifest> 태그의 package 속성 값을 새로운 패키지 이름으로 변경합니다.
2. iOS:
   • ios/Runner.xcworkspace 파일을 Xcode에서 실행합니다.
   • 프로젝트 내비게이션에서 Runner > TARGETS Runner > Bundle Identifier 항목을 찾아 새로운 패키지 이름으로 변경합니다.
3. change_app_package_name 라이브러리 활용(적극 권장):
   • 터미널을 열고 아래의 명령어로 change_app_package_name 라이브러리를 설치합니다:

     flutter pub add change_app_package_name

   • 설치가 완료되면, 아래의 명령어를 사용하여 새로운 패키지 이름으로 한 번에 변경할 수 있습니다:

     flutter pub run change_app_package_name:main com.new.package.name

해당 방법을 사용하면 빠지는 부분 없이 정말 간단하게 패키지명을 수정하실 수 있습니다. 무조건 쓰세요!

결론:

• Flutter 앱의 패키지 이름 변경은 출시 전 필수적인 단계 중 하나입니다. 이 글이 그 과정을 조금 더 쉽게 만드는 데 도움이 되었기를 바랍니다.
• 변경 과정에서 문제가 발생하면, 공식 Flutter 문서나 커뮤니티 포럼에 문의하여 추가 지원을 받으세요.

중요 참고사항:

• Flutter에서 패키지 이름을 변경할 때, Android 앱의 경우 build.gradle의 applicationId와 AndroidManifest.xml의 package 값을 수정하는 것이 핵심입니다.
• 일부 자료에서는 Java/Kotlin 소스 파일 내의 import 문의 패키지명도 전부 변경하는 것을 권장할 수 있지만, 이는 실제로 필요한 단계가 아닙니다. Flutter 프레임워크와 Android 빌드 시스템은 build.gradle과 AndroidManifest.xml에서 설정된 패키지 이름을 기준으로 앱을 인식하고, 이 두 파일에서 패키지명을 올바르게 변경했다면, 앱은 변경된 패키지명으로 정상적으로 빌드되고 실행됩니다. (배포 후에도 문제없음)
• 소스 코드 내의 패키지명을 변경하는 것은 불필요한 작업이며, 오히려 불필요한 오류를 발생시킬 수 있으니, 위에서 언급한 핵심 파일들의 설정값만 정확히 변경해주시면 됩니다.
  (그냥 change_app_package_name  라이브러리 다운받고 원하는 패키지명 적자.)

이 점을 명심하시고 패키지명 변경 작업을 진행하시면, 더 효율적이고 안정적인 방법으로 작업을 완료할 수 있을 것입니다.

참고자료:

• Flutter 공식 문서
• change_app_package_name 패키지