SDK 버전 2.0.0 이상에서의 마이그레이션 방법

버전 2.0.0 내의 구조 변경

• 요청 메소드와 클래스가 정적 메소드와 클래스로 대체되었습니다.
• 프로젝트 ID는 메소드에 매개변수로 전달되지 않습니다. SDK는 프로젝트 설정에 지정된 값을 사용합니다.
• 사용자의 인증 토큰은 메소드에 매개변수로 전달되지 않으며 콜백 함수에 의해 반환되지 않습니다. SDK는 사용자의 이전 인증을 기반으로 토큰을 결정하며 이 토큰을 카탈로그 가져오기, 구매하기 및 인벤토리 표시하기 메소드에 전달합니다.
• 모바일 장치에 대한 정보를 결정하는 논리가 SDK에 추가되었습니다. 데이터는 DeviceInfo 구조로 캡슐화됩니다.

변경 사항의 전체 목록은 сhangelog에서 확인하세요.

XsollaAuth 클래스 업그레이드

• XsollaAuth.Instance 호출을 XsollaAuth로 대체합니다.
• 인증 메소드를 호출할 때 사용되는 onSuccess 콜백 메소드의 서명을 변경합니다. Action<string>을 Action으로 대체합니다.
• RefreshOAuthToken 메소드를 호출할 때 refreshToken 매개변수 전달을 제거합니다.
• GetUserInfo 메소드를 호출할 때 token 매개변수 전달을 제거합니다.
• 메소드를 호출할 때 XsollaAuth.Instace.OAuthLogout에 대한 호출을 XsollaAuth.Logout으로 바꾸고 token 매개변수의 전달을 제거합니다.
• AuthViaDeviceID 메소드를 호출할 때 deviceType, deviceId, device 매개변수 전달을 제거합니다. 모바일 장치 정보를 결정하는 논리를 제거합니다.
• Register 메소드를 호출할 때 사용되는 onSuccess 콜백 메소드의 서명을 변경합니다. Action<int>, Action, Action<LoginUrlResponse>을 Action<LoginLink>으로 대체합니다.
• SignIn 메소드를 호출할 때 rememberMe 매개변수 전달을 제거합니다.
• StartAuthByEmail 및 StartAuthByPhoneNumber 메소드를 호출할 때 사용되는 onSuccess 콜백 메소드의 서명을 변경합니다. Action<string>을 Action<OperationId>으로 대체합니다.

XsollaCart 클래스 업그레이드

• XsollaCart.Instance 호출을 XsollaCart로 대체합니다.
• XsollaCart.Instance.PurchaseCart 호출을 XsollaCart.CreateOrder로 대체합니다.
• 클래스 메소드를 호출할 때 projectId 매개변수 전달을 제거합니다.
• 현재 사용자의 장바구니로만 작업하는 경우 클래스 메소드를 호출할 때 cartId 매개변수 전달을 제거합니다.

XsollaOrders 클래스 업그레이드

• XsollaOrders.Instance 호출을 XsollaOrders로 대체합니다.
• OpenPurchaseUI 메소드 호출 코드를 변경합니다. 결제 토큰을 paymentToken 매개변수로 전달합니다(purhaseData 매개변수가 paymentToken로 대체됨).
• OpenPurchaseUI 메소드를 호출할 때 사용되는 onBrowserClosed 콜백 메소드의 서명을 변경합니다. Action<bool>을 Action<BrowserCloseInfo>으로 대체합니다.
• 클래스 메소드를 호출할 때 projectId 매개변수 전달을 제거합니다.

XsollaUserAccount 클래스 업그레이드

• XsollaUserAccount.Instance 호출을 XsollaUserAccount로 대체합니다.
• 클래스 메소드를 호출할 때 token 매개변수 전달을 제거합니다.

XsollaSubscriptions 클래스 업그레이드

• XsollaSubscriptions.Instance 호출을 XsollaSubscriptions로 대체합니다.
• 클래스 메소드를 호출할 때 projectId 매개변수 전달을 제거합니다.

XsollaInventory 클래스 업그레이드

• XsollaInventory.Instance 호출을 XsollaInventory로 대체합니다.
• 클래스 메소드를 호출할 때 projectId 매개변수 전달을 제거합니다.

XsollaGameKeys 클래스 업그레이드

• XsollaGameKeys.Instance 호출을 XsollaGameKeys로 대체합니다.
• 클래스 메소드를 호출할 때 projectId 매개변수 전달을 제거합니다.

토큰 클래스 업그레이드

• Token.Instance 호출을 XsollaToken으로 대체합니다.
• Token.Instance.GetSteamUserID 호출을 SteamUItils.GetSteamUserId로 대체합니다.
• 액세스 및 새로 고침 토큰의 값을 가져오려면 코드를 수정합니다. XsollaToken.AccessToken 및 XsollaToken.RefreshToken 속성을 사용합니다.

유틸리티 클래스 업그레이드

• AndroidSDKSocialAuthHelper 및 IosSDKSocialAuthHelper 클래스의 사용을 XsollaAuth.AuthViaSocialNetwork 호출로 대체합니다.
• AndroidSDKPaymentsHelper 및 IosSDKPaymentsHelper 클래스의 사용을 XsollaWebBrowser.OpenPurchaseUI 호출로 대체합니다.

패키지 교체

1. Unity 프로젝트를 엽니다.
2. Xsolla 폴더를 삭제합니다.
3. SDK 또는 데모 프로젝트 패키지를 다운로드합니다.

4. 패키지 압축을 해제합니다.
5. Unity 에디터에서 메인 메뉴에 있는 Assets > Import Package > Custom Package로 가서 SDK 또는 데모 패키지를 선택합니다.
6. 종속성 경고 윈도우에서 Install/Upgrade(을)를 클릭합니다. 그 결과 Import Unity Package 확인된 파일 목록이 있는 윈도우가 열리고 설치 준비가 됩니다. 목록에는 변경되지 않은 파일, 추가되는 파일 및 대체되는 파일이 표시됩니다.
7. Import(을)를 클릭합니다.
8. 애플리케이션을 테스트하고 필요에 따라 프로젝트 코드를 변경합니다.