해당 글에서는 React Native 환경에서 react-native-rename을 이용하여서 프로젝트 명, 패키지 명을 일괄적으로 변경하는 방법에 대해 알아봅니다
1) react-native-rename
💡 react-native-rename
- React Native 프로젝트의 이름과 번들 ID(패키지명)를 변경해 주는 CLI 도구입니다. - 프로젝트 생성 이후 앱 이름이나 번들 ID(예: Android의 com.example.app, iOS의 org.reactjs.native.example.MyApp)를 바꾸고 싶을 때 유용하게 사용됩니다.
# yarn으로 설치
$ yarn global add react-native-rename
# or
# npm으로 설치
$ npm install react-native-rename -g
3) react-native-rename 사용방법 -1 : 기초 변경
1. 프로젝트에 접근합니다
2. 터미널 내에서 해당 명령어를 입력합니다.
💡 터미널 내에서 해당 명령어를 입력합니다.
- 앱의 이름만 변경하는 경우나 혹은 앱 이름과 패키지를 변경하는 두 가지 경우가 있습니다.
# 앱 이름만 변경하는 경우
$ react-native-rename "LottoGenerator"
# 앱 이름과 패키지를 변경하는 경우
npx react-native-rename "LottoGenerator" -b "com.tha.lottogenerator"
💡 [참고] 아래와 같은 문제가 발생하는 경우도 있습니다.
- The directory is not clean. There are changes that have not been committed to the Git repository. Clean it first and try again or use "--skipGitStatusCheck" option to skip this
- 해당 경우에는 git 내에 올리지 않은 commit & push가 존재하기에 정리된 상태로 수행을 해야 합니다. commit과 push를 하고 다시 명령어를 수행하면 실행이 됩니다.
4) react-native-rename 사용방법 -1 : 플랫폼별 추가 변경
1. 안드로이드
1.1. MainActivity.kt
💡 MainActivity.kt
- 아래와 같이 패키지 명과 안드로이드 메인 컴포넌트 이름(앱 이름)을 수동으로 변경해 줍니다.