설정 플러그인 소개

프로젝트에 네이티브 모듈을 추가하기 위한 자동 설정이 가능하다. 하지만 때로는 모듈이 더 복잡한 설정을 요구하기도 한다. 이 때 설정 플러그인(config plugin)을 사용하면 모듈에 맞게 네이티브 프로젝트를 자동으로 구성하고, 네이티브 프로젝트와의 직접적인 상호 작용을 피함으로써 복잡성을 줄일 수 있다.

설정 플러그인이란?

설정 플러그인은 앱 설정을 확장하고 앱의 사전 빌드(prebuild) 프로세스를 커스터마이징하는 시스템이다. 기본적으로 포함되지 않은 네이티브 모듈을 추가하거나, 추가 설정이 필요한 네이티브 코드를 추가하는 데 사용할 수 있다.

내부적으로 Expo CLI는 설정 플러그인을 사용하여 관리되는 프로젝트의 모든 네이티브 코드를 생성하고 구성한다. 플러그인은 앱 아이콘 생성, 앱 이름 설정, AndroidManifest.xml, Info.plist 등을 구성하는 작업을 수행한다.

플러그인은 네이티브 프로젝트를 위한 번들러와 같다. npx expo prebuild 를 실행하면 모든 프로젝트 플러그인을 평가하여 프로젝트를 번들링한다. 이렇게 하면 android와 ios 디렉토리가 생성된다. 이 디렉토리는 생성된 후 수동으로 수정할 수 있지만, 수동 수정 사항을 덮어쓸 가능성이 있기 때문에 더 이상 안전하게 재생성할 수 없다.

설정 플러그인 사용하기

Expo 설정 플러그인은 대부분 Node.js 모듈에서 제공된다. 프로젝트의 다른 패키지와 마찬가지로 설치할 수 있다.

예를 들어, expo-camera 에는 AndroidManifest.xml과 Info.plist에 카메라 권한을 추가하는 플러그인이 있다. 프로젝트에 설치하려면 다음 명령을 실행한다:

npx expo install expo-camera

앱의 설정(app.json 또는 app.config.js)에서 expo-camera 를 플러그인 목록에 추가할 수 있다:

// app.json
{
  "expo": {
    "plugins": ["expo-camera"]
  }
}

expo-camera 와 같은 일부 플러그인은 두 번째 인자로 옵션을 전달하여 커스터마이징 할 수 있다:

// app.json
{
  "expo": {
    "plugins": [
      [
        "expo-camera",
        {
          "cameraPermission": "Allow $(PRODUCT_NAME) to access your camera."
        }
      ]
    ]
  }
}

npx expo prebuild 를 실행하면 mods 가 컴파일되고 네이티브 파일이 변경된다.

변경 사항은 Xcode와 같은 도구로 네이티브 프로젝트를 다시 빌드할 때까지 적용되지 않는다. 관리되는 앱에서 설정 플러그인을 사용하는 경우 eas build 중 사전 빌드 단계에서 적용된다.