설치

Wepin Compose Multiplatform Login Library를 설치하는 방법을 설명합니다.

요구사항

• Android: API 버전 21 이상

• iOS: 버전 13.0 이상

  • Compose Multiplatform 프로젝트의 ios/Podfile에서 platform :ios 버전을 13.0 으로 업데이트하고, 필요에 따라 ios/Podfile을 확인하고 수정해야 합니다.

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

OAuth 로그인 제공자 설정

OAuth 로그인 기능(예: loginWithOauthProvider)을 사용하려면 OAuth 로그인 제공자를 설정해야 합니다. 이를 위해 Wepin Workspace에 OAuth 로그인 제공자 정보를 먼저 등록해야 합니다. Wepin Workspace의 Developer Tools 메뉴에서 Login 탭으로 이동한 후, Login Provider 섹션에서 App 또는 Set Login Provider 버튼을 클릭하여 등록을 완료하세요.

설치하기

Wepin Compose Multiplatform Login Library 는 Maven Central 에 배포되어 있으며, build.gradle 에 dependency를 추가하여 설치할 수 있습니다. build.gradle.kt 의 commonMain dependency에 wepin-compose-sdk-login-v1 를 추가합니다.

val commonMain by getting { 
    api("io.wepin:wepin-compose-sdk-login-v1:0.0.11") 
}

iOS

iOS 종속 라이브러리는 CocoaPods를 사용해 설치해야 합니다.

1. build.gradle 파일에 cocoapods plugin 을 추가하고 AppAuth, secp256k1, JFBCrypt 라이브러리 정보를 입력한 후 "Synk Project with Gradle Files" 를 클릭하면 shared.podspec 파일이 생성됩니다.

2. iosApp 폴더 내에 Podfile 을 추가합니다.

   1. Podfile 에 최소 iOS 버전을 13.0으로 설정해줘야 합니다.

//build.gradle.kt(shared)
plugins {
    kotlin("native.cocoapods")
}

kotlin {
    cocoapods {
        summary = "Some description for a Kotlin/Native module"
        homepage = "Link to a Kotlin/Native module homepage"
        ios.deploymentTarget = "13.0"
        version = "0.0.1"

        pod("AppAuth") {
            version = "~> 1.7.5"
        }

        pod("secp256k1") {
            version = "~> 0.1.0"
        }

        pod("JFBCrypt") {
            version = "~> 0.1"
        }
    }
}

// Podfile
post_install do |installer|
    installer.generated_projects.each do |project|
        project.targets.each do |target|
            target.build_configurations.each do |config|
                config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
            end
        end
    end
end

설정하기

Deep Link 설정

OAuth 로그인 기능(loginWithOauthProvider)을 활성화하려면 Deep Link 스킴을 설정해야 합니다.

• Deep Link scheme format : wepin. + Wepin 앱 ID

Android

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

build.gradle(app)

// Deep Link 설정 => 리디렉션 스킴 형식: wepin. + Wepin 앱 ID
android.defaultConfig.manifestPlaceholders = [
  'appAuthRedirectScheme': 'wepin.{{YOUR_WEPIN_APPID}}'
]

AndroidManifest.xml
<activity
      android:name="com.wepin.android.loginlib.RedirectUriReceiverActivity"
      android:exported="true">
      <intent-filter>
          <action android:name="android.intent.action.VIEW" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.BROWSABLE" />
          <data
              android:host="oauth2redirect"
              android:scheme="${appAuthRedirectScheme}" />
      </intent-filter>
</activity>

iOS

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

Info.plist

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>unique name</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>wepin.{{YOUR_WEPIN_APPID}}</string>
        </array>
    </dict>
</array>