설치

Wepin ReactNative Widget SDK를 설치하는 방법을 설명합니다.

요구사항

• React Native 버전 0.71.8이상

• Android: API 버전 24이상

• iOS: 버전 13.0 이상

해당 패키지는 Android, iOS 환경에서만 사용 가능합니다. Web, MacOS, Window, Linux 환경에서는 사용할 수 없습니다.

New Architecture는 아직 지원되지 않습니다

설치하기

npm 패키지로 설치할 수 있습니다.

npm

npm install @wepin/sdk-rn

yarn

peerDependencies

npm

npm install react-native-device-info

# for ios
cd ios
pod install

yarn

설정하기

OAuth 로그인 기능을 활성화하려면 딥 링크 스킴(Deep Link Scheme) 을 구성해야 합니다. 딥 링크 스킴 형식(Deep Link scheme format) : wepin. + Your Wepin App ID

Android

build.gradle (app) 파일에서 manifestPlaceholders를 추가하여 Wepin Widget SDK가 이 커스텀 스킴을 통한 모든 리디렉션을 쉽게 캡처할 수 있도록 설정합니다.

// For Deep Link => RedirectScheme Format : wepin. + Wepin App ID
android.defaultConfig.manifestPlaceholders = [
  'appAuthRedirectScheme': 'wepin.{{YOUR_WEPIN_APPID}}'
]

iOS

인증 프로세스 후 앱으로 다시 리디렉션하기 위해 앱의 URL 스킴을 Info.plist 파일에 추가해야 합니다.

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>unique name</string>
        <array>
            <string>wepin + your Wepin app id</string>
        </array>
    </dict>
</array>

iOS Podfile 설정

Xcode 26.0.1 이상 버전 사용 시 빌드 에러가 발생할 수 있습니다.

error Unable to find module dependency: 'bcrypt' (in tarrget 'WepinLogin' from project 'Pods')

위와 같은 에러가 발생하는 경우 Podfile 에 아래 코드를 추가해주세요.

post_install do |installer| 
  installer.pods_project.targets.each do |target| 
    target.build_configurations.each do |config| 
      config.build_settings['SWIFT_ENABLE_EXPLICIT_MODULES'] = 'NO' 
    end 
  end 
end