Skip to main content
Version: Next

로컬 라이브러리 설정

로컬 라이브러리는 앱에 국한된 뷰나 모듈을 포함하며, 레지스트리에 게시되지 않은 라이브러리다. 기존의 뷰와 모듈 설정과 달리, 로컬 라이브러리는 앱의 네이티브 코드와 분리되어 있다.

로컬 라이브러리는 android/와 ios/ 폴더 외부에 생성되며, 앱과의 통합을 위해 오토링킹을 사용한다. 로컬 라이브러리가 포함된 구조는 다음과 같다:

plaintext
MyApp
├── node_modules
├── modules <-- 로컬 라이브러리를 위한 폴더
│ └── awesome-module <-- 로컬 라이브러리
├── android
├── ios
├── src
├── index.js
└── package.json

로컬 라이브러리의 코드가 android/와 ios/ 폴더 외부에 존재하기 때문에, 추후 React Native 버전을 업그레이드하거나 다른 프로젝트로 복사하는 것이 더 쉬워진다.

로컬 라이브러리를 생성하려면 create-react-native-library를 사용한다. 이 도구는 필요한 모든 템플릿을 포함하고 있다.

시작하기​

React Native 애플리케이션의 루트 폴더에서 다음 커맨드를 실행한다:

shell
npx create-react-native-library@latest awesome-module

여기서 awesome-module은 새 모듈에 붙일 이름이다. 프롬프트를 따라 진행한 후 프로젝트 루트 디렉토리에 modules라는 새 폴더가 생성된다. 이 폴더 안에는 새 모듈이 포함되어 있다.

기본적으로 생성된 라이브러리는 Yarn을 사용할 때는 link: 프로토콜을 통해, npm을 사용할 때는 file: 프로토콜을 통해 프로젝트에 자동으로 연결된다:

json
"dependencies": {
  "awesome-module": "file:./modules/awesome-module"
}

이렇게 하면 node_modules 아래에 라이브러리에 대한 심볼릭 링크가 생성되어 자동 연결이 작동한다.

의존성 설치​

모듈을 연결하려면 필요한 의존성을 설치해야 한다:

shell
npm install

앱 내부에서 모듈 사용하기​

앱 내부에서 모듈을 사용하려면 모듈 이름으로 가져오면 된다:

js
import {multiply} from 'awesome-module';