React Native는 앱에서 사용할 수 있는 빌트인 코어 컴포넌트와 API들을 제공합니다. React Native와 함께 번들로 제공되는 컴포넌트와 API만 사용할 수 있는 것은 아닙니다. React Native 커뮤니티에는 수 천명의 개발자들이 있습니다. 만약 코어 컴포넌트나 API에 원하는 기능이 없는 경우, 커뮤니티에서 라이브러리를 찾아 설치하여 앱에 기능을 추가할 수 있습니다.
React Native 라이브러리는 일반적으로 npm CLI 또는 Yarn 클래식과 같은 Node.js 패키지 매니저를 사용하는 npm 레지스트리를 통해 설치됩니다.
컴퓨터에 Node.js가 설치되어 있다면 npm CLI도 이미 설치되어 있습니다. 일부 개발자는 설치 시간을 약간 단축하고, Workspaces와 같은 고급 기능을 추가로 사용하기 위해 Yarn 클래식 사용을 선호하기도 합니다. 두 가지 툴 모두 React Native에서 잘 작동합니다. 단순하게 설명하기 위해서 이 가이드에서는 npm을 사용하는 것으로 가정하겠습니다.
💡 JavaScript 커뮤니티에서는 "라이브러리"와 "패키지"라는 용어를 따로 구별하지 않고 같은 뜻으로 사용합니다.
프로젝트에 라이브러리를 설치하려면, 터미널에서 프로젝트 디렉토리로 들어가서 설치 명령어를 실행합니다. react-native-webview 로 시작해봅시다.
-
npm
npm install react-native-webview
-
Yarn
yarn add react-native-webview
설치된 라이브러리는 네이티브 코드를 포함하며, 사용하기 전에 앱에 먼저 연결해야 합니다.
React Native는 CocoaPods를 사용해 iOS 프로젝트 종속성을 관리하고, 대부분의 React Native 라이브러리는 동일한 규칙을 따릅니다. 만약 사용 중인 라이브러리가 CocoaPods을 사용하지 않는 경우, 해당 라이브러리의 README를 추가로 참고하세요. 대부분의 경우, 다음 지침을 따르면 됩니다.
ios 디렉토리에서 pod install 을 실행해 네이티브 iOS 프로젝트에 라이브러리를 연결합니다. ios 디렉토리로 이동하지 않고 이 작업을 수행하려면 npx pod-install 을 실행합니다.
npx pod-install완료되면, 새로운 라이브러리 사용을 위해 앱 바이너리를 다시 빌드하십시오.
npx react-native run-iosReact Native는 Android 프로젝트 종속성 관리에 Gradle을 사용합니다. 네이티브 종속성을 가진 라이브러리를 설치한 후에는, 새로운 라이브러리 사용을 위해 앱 바이너리를 다시 빌드해야 합니다.
npx react-native run-androidReact Native 디렉토리는 React Native용으로 제작된, 검색이 가능한 라이브러리 데이터베이스입니다. React Native 앱에 사용할 라이브러리는 이 곳에서 가장 먼저 찾아볼 수 있습니다.
디렉토리에서 찾게 될 라이브러리 중 대다수는 React Native 커뮤니티 또는 Expo에서 가져온 것입니다.
React Native 커뮤니티에서 제작된 라이브러리는 React Native를 사용하는 회사의 자원봉사자와 개인에 의해 구동됩니다. iOS, tvOS, Android, Windows를 지원하는 경우가 많지만, 지원 범위는 프로젝트마다 다릅니다. 많은 라이브러리가 React Native 코어 컴포넌트와 API를 기반으로 만들어졌습니다.
Expo에서 제작된 라이브러리는 모두 TypeScript로 작성되었으며, iOS, Android, react-native-web을 지원합니다. React Native 앱에서 사용하려면 일반적으로 react-native-unimodules을 먼저 설치해야 합니다.
디렉토리에서 React Native에 적합한 라이브러리를 찾을 수 없는 경우에는, React Native 디렉토리 다음으로 npm 레지스트리를 확인해보는 것이 좋습니다. npm 레지스트리는 JavaScript 라이브러리의 최종적인 소스이지만, 이 곳의 라이브러리들은 React Native와 모두 호환되지는 않을 수도 있습니다. React Native는 Node.js, 웹 브라우저, Electron 등 많은 JavaScript 프로그래밍 환경 중 하나이며, npm에는 이러한 모든 환경에서 작동하는 라이브러리들을 포함되어 있기 때문입니다.
일반적으로 다른 플랫폼 전용으로 구축된 라이브러리는 React Native에서 작동하지 않습니다. 웹 전용으로 구축되었으며 react-dom 을 타겟으로 하는 react-select, Node.js를 위해 구축되었으며 컴퓨터 파일 시스템과 상호 작용하는 rimraf 등이 그 예입니다. lodash 와 같은 다른 라이브러리들은 JavaScript 언어의 기능만을 사용해 어떤 환경에서도 작동합니다. 시간이 지남에 따라 이 부분에 대해 감을 잡게 되겠지만, 그 전까지 가장 쉬운 방식은 직접 시도해보는 것입니다. 해당 라이브러리가 React Native와 호환되지 않는 경우 npm uninstall 을 사용해 패키지를 제거할 수 있습니다.
React Native 디렉토리에서는 iOS, Android, 웹, Windows와 같은 플랫폼 호환성에 따라 필터링을 할 수 있습니다. 사용하려는 라이브러리가 현재 목록에 없는 경우, 자세한 내용은 해당 라이브러리의 README를 참조하십시오.
라이브러리의 최신 버전은 일반적으로 React Native의 최신 버전과 호환됩니다. 이전 버전을 사용하는 경우, README를 참고해 어떤 버전의 라이브러리를 설치해야하는지 확인해야 합니다. npm install <library-name>@<version-number> 를 실행해 라이브러리의 특정 버전을 설치할 수 있습니다. 예: npm install @react-native-community/netinfo@^2.0.0.