Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
e30ae60
7월 비정기배포 iOS 가이드 추가
phillip5094 Jul 9, 2025
15c463c
7월 비정기배포 Android 가이드 추가
bhbac-nhnent Jul 9, 2025
11298ef
Android 최소 지원 버전 변경(minSdk 21 -> 22, AGP 4.0.1 -> 7.4.2)
bhbac-nhnent Jul 11, 2025
eb355d6
Android 가이드 문서 오류 수정
bhbac-nhnent Jul 11, 2025
95cbd2e
Android 릴리스 노트 내용 추가
bhbac-nhnent Jul 13, 2025
0c3f784
iOS 7월 비정기배포 릴리즈노트 수정
phillip5094 Jul 14, 2025
6232fe6
7월 비정기배포 Unity 가이드 추가
smflt-nhn Jul 14, 2025
a9934eb
7월 비정기 배포 Unreal 가이드 추가
lurim-nhn Jul 15, 2025
f57a109
Update ko/ios-etc.md
phillip5094 Jul 16, 2025
250eb73
Update ko/ios-etc.md
phillip5094 Jul 16, 2025
a02f8eb
Update ko/release-notes-unity.md
phillip5094 Jul 16, 2025
08e80f1
Apply suggestions from code review
bhbac-nhnent Jul 16, 2025
773fc64
Apply suggestions from code review
meditation-nhn Jul 16, 2025
aa67c9e
Update ko/unity-etc.md
smflt-nhn Jul 16, 2025
26de6f8
Update ko/unity-etc.md
smflt-nhn Jul 16, 2025
c59ed35
7월 비정기 배포 Unreal 한글 검수 반영
lurim-nhn Jul 18, 2025
712b1ec
7월 비정기 배포 Unity 한글 검수 반영
smflt-nhn Aug 8, 2025
e6a105f
Update en/release-notes-ios.md
phillip5094 Sep 1, 2025
a1a461a
Update en/release-notes-unity.md
smflt-nhn Sep 1, 2025
f328c7e
Update en/unity-authentication.md
smflt-nhn Sep 1, 2025
7da5db5
Apply suggestions from code review
bhbac-nhnent Sep 1, 2025
709cb64
Unreal 7월 비정기배포 영어 번역 반영
lurim-nhn Sep 4, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 8 additions & 28 deletions en/aos-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ To execute Gamebase in Android, the following system environment is required.

> [Minimum Specifications]
>
> * User execution environment: Android API 21 (Lollipop, OS 5.0) or higher
> * Build environment: Android Gradle Plugin 4.0.1 or higher
> * User execution environment: Android API 22 (Lollipop MR1, OS 5.1) or higher
> * Build environment: Android Gradle Plugin 7.4.2 or higher
> * Development environment: Android Studio

### Dependencies
Expand All @@ -26,7 +26,6 @@ To execute Gamebase in Android, the following system environment is required.
| | gamebase-adapter-auth-payco | payco-login-1.5.15| Support PAYCO login | - |
| | gamebase-adapter-auth-twitter | - | Support Twitter login | - |
| | gamebase-adapter-auth-weibo | sinaweibosdk.core-13.5.0 | Support Weibo login | - |
| | gamebase-adapter-auth-weibo-v4 | openDefault-4.4.4 | Support Weibo login | - |
| | gamebase-adapter-auth-kakaogame | kakaogame.idp_kakao-3.19.3<br>kakaogame.gamesdk-3.19.3<br>kakaogame.common-3.19.3<br>kakao.sdk.v2-auth-2.17.0<br>kakao.sdk.v2-partner-auth-2.17.0<br>kakao.sdk.v2-common-2.17.0<br>play-services-ads-identifier-17.0.0 | Support Kakao login | API 23(Marshmallow, OS 6.0) |
| | gamebase-adapter-auth-steam | - | Support Steam login | API 25(Nougat, OS 7.1.1) |
| Gamebase IAP Adapters | gamebase-adapter-toastiap | nhncloud-iap-core | Support in-app purchase | - |
Expand Down Expand Up @@ -156,6 +155,10 @@ dependencies {
implementation "com.toast.android.gamebase:gamebase-adapter-auth-weibo:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-steam:$GAMEBASE_SDK_VERSION"

// >>> [Purchase Support under Android 7.0(API Level 24)]
// desugar_jdk_libs 2.+ needs AGP 7.4+
coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")

// >>> Gamebase - Select Purchase Adapter
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-google:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v21:$GAMEBASE_SDK_VERSION"
Expand All @@ -174,10 +177,6 @@ dependencies {
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejp:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejpemail:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-kakaogame:$GAMEBASE_SDK_VERSION"
// >>> [Weibo v4]
// https://github.com/nhn/toast.gamebase.android.sample/tree/main/weibo_sdk
implementation files('libs/openDefault-4.4.4.aar')
implementation "com.toast.android.gamebase:gamebase-adapter-auth-weibo-v4:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v16]
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v16:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v17]
Expand All @@ -194,33 +193,14 @@ dependencies {

android {
compileOptions {
// >>> [AndroidX]
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}

defaultConfig {
// >>> [Weibo IdP]
ndk {
abiFilters 'armeabi' // , 'armeabi-v7a', 'arm64-v8a'
}
// >>> [Purchase Support under Android 7.0(API Level 24)]
coreLibraryDesugaringEnabled true
}
}
```

### Resources

#### Weibo IdP

* Depending on your build target, download the so files from the following URLs and copy them to your project.
* https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/so
* In case of Android Studio build
* Copy under the project's src/main/java/jniLibs folder.
* ![Add so file to Android Studio project](https://static.toastoven.net/prod_gamebase/DevelopersGuide/aos-started-resources-weibo-so-android-studio-2.53.0.png)
* In case of Unity build
* Copy the so and foler under the Assets/Plugins/Android/libs.
* ![Add so file to Unity project](https://static.toastoven.net/prod_gamebase/DevelopersGuide/aos-started-resources-weibo-so-unity-2.53.0.png)

#### Huawei Store

* You must add the AppGallery Connection configuration file (agconnect-services.json) to the assets folder.
Expand Down
2 changes: 1 addition & 1 deletion en/ios-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
> Minimum specifications
>
> * User run environment : iOS 12 or later
> * Build environment : Xcode 15 (iOS 16.1 SDK) or later
> * Build environment : Xcode 16 (iOS 18 SDK) or later
>

<br/>
Expand Down
20 changes: 19 additions & 1 deletion en/release-notes-android.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,30 @@
## Game > Gamebase > Release Notes > Android

### 2.73.0 (2025. 07. 15.)

[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.73.0/GamebaseSDK-Android.zip)

```
The minimum supported version has been increased to Android 5.1 or later. (minSdk 21 → 22)
The minimum Android Gradle Plugin version has been increased to 7.4.2 or later. (4.0.1 -> 7.4.2)
```

#### Feature Updates

* Improved internal logic

#### Bug Fixes

* Fixed an issue where the login webview would incorrectly calculate margin sizes when rotating the screen.

### 2.72.0 (2025. 06. 24.)

[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.0/GamebaseSDK-Android.zip)

#### 기능 개선/변경

* 웹소켓 모듈이 중복 호출되는 경우 ArrayIndexOutOfBoundsException이 발생할 수 있는 로직 수정
* Fixed logic that could cause ArrayIndexOutOfBoundsException when the websocket module was called multiple times.
* This issue only occurs in Gamebase Android SDK 2.71.2.

#### 버그 수정

Expand Down
15 changes: 15 additions & 0 deletions en/release-notes-ios.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,20 @@
## Game > Gamebase > Release Notes > iOS

### 2.73.0 (2025. 07. 15.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.73.0/GamebaseSDK-iOS.zip)

#### Feature Updates
* The minimum supported version of Xcode has been changed to 16.0.

#### Bug Fixes
* Fixed a bug where the agreed terms and conditions information was not saved when calling updateTerms after logging in.

### 2.72.1 (July 1, 2025)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.1/GamebaseSDK-iOS.zip)

#### Feature Updates
* Fixed a bug that caused GameCenter to crash when logging in on certain iOS 14 devices.

### 2.72.0 (2025. 06. 24.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.0/GamebaseSDK-iOS.zip)

Expand Down
19 changes: 19 additions & 0 deletions en/release-notes-unity.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
## Game > Gamebase > Release Notes > Unity

### 2.73.0 (2025. 07. 15.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.73.0/GamebaseSDK-Unity.zip)

#### Added Features

#### Feature Updates
- (Windows, macOS) Changed from webview to external browser when logging in to IdP.
- Supported Browsers
- Windows : every browser
- macOS : Chrome, Safari, Firefox, whale

- Added external browser login cancellation API.
- To change the IDP during an ongoing external browser login request, cancel the existing request.
- CancelLoginWithExternalBrowser()

#### Platform-specific Changes
* [Gamebase Android SDK 2.73.0](./release-notes-android/#2730-2025-07-15)
* [Gamebase iOS SDK 2.73.0](./release-notes-ios/#2730-2025-07-15)

### 2.72.0 (2025. 06. 24.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.0/GamebaseSDK-Unity.zip)

Expand Down
23 changes: 23 additions & 0 deletions en/release-notes-unreal.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,28 @@
## Game > Gamebase > Release Notes > Unreal

### 2.73.0 (2025. 07. 15.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.73.0/GamebaseSDK-Unreal.zip)

#### Feature Updates

* (Windows) For IdPs that do not use SDKs, the process has been changed to proceed with external browser login.
* An API has been added to cancel login when an external browser login is in progress.
* CancelLoginWithExternalBrowser
* Please refer to the following guide document for how to call the API.
* [Game > Gamebase > Unreal SDK User Guide > Authentication> Login > Login with IdP > Cancel Login with External Browser](./unreal-authentication/#cancel-login-with-external-browser)
* (Windows) Added a message when logging into Steam to indicate Steamworks initialization failure to help identify the cause.
* Improved internal logic.

#### Bug Fixes

* Fixed EOSSDK module not being included when not using Epic Games-related features.
* (Windows) Fixed a crash when using an unconfigured store in the console.

#### Platform-specific Changes

* [Gamebase Android SDK 2.73.0](./release-notes-android/#2730-2025-07-15)
* [Gamebase iOS SDK 2.73.0](./release-notes-ios/#2730-2025-07-15)

### 2.72.0 (2025. 06. 24.)
[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.0/GamebaseSDK-Unreal.zip)

Expand Down
57 changes: 54 additions & 3 deletions en/unity-authentication.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,9 +194,7 @@ For more information on IdP types that can be used to log in, refer to the **Gam

> <font color="red">[Caution]</font><br/>
>
> In Standalone, login is supported through WebViewAdapter. It does not block events entered via UI when WebView is open.
>
> To log in using Standalone WebViewAdapter, the CallbackURL below must be configured on the IdP Developer website.
> To log in to IdP in Standalone, you must set the CallbackURL below on the IdP developer site.
> - https://id-gamebase.toast.com/oauth/callback
>

Expand Down Expand Up @@ -284,6 +282,59 @@ public void LoginWithAdditionalInfo()
}
```

### Login Cancel

**API**

Supported Platforms
<span style="color:#F9D0C4; font-size: 10pt">■</span> UNITY_STANDALONE

```cs
static void CancelLoginWithExternalBrowser()
```

**Example**
```cs
public void Login()
{
Gamebase.Login(GamebaseAuthProvider.FACEBOOK, (authToken, error) =>
{
if (Gamebase.IsSuccess(error))
{
string userId = authToken.member.userId;
Debug.Log(string.Format("Login succeeded. Gamebase userId is {0}", userId));
}
else
{
// Check the error code and handle the error appropriately.
Debug.Log(string.Format("Login failed. error is {0}", error));
if (error.code == GamebaseErrorCode.AUTH_LOGIN_CANCEL_FAILED)
{
// TODO: Handle the cancellation...
}
else if (error.code == (int)GamebaseErrorCode.SOCKET_ERROR || error.code == (int)GamebaseErrorCode.SOCKET_RESPONSE_TIMEOUT)
{
Debug.Log(string.Format("Retry Login or notify an error message to the user.: {0}", error.message));
}
else if (error.code == GamebaseErrorCode.BANNED_MEMBER)
{
GamebaseResponse.Auth.BanInfo banInfo = GamebaseResponse.Auth.BanInfo.From(error);
if (banInfo != null)
{
}
}
}
});
}

public void CancelLoginWithExternalBrowser()
{
// This method only initiates an asynchronous request.
// The result of the cancellation is handled in the callback of the Login method.
Gamebase.CancelLoginWithExternalBrowser();
}
```

### Login with Credential

This game interface allows authentication to be made with SDK provided by IdP, before login to Gamebase with provided access token.
Expand Down
8 changes: 8 additions & 0 deletions en/upgrade-guide.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
## Game > Gamebase > Upgrade Guide

## 2.71.2

### Android

* Gamebase Android SDK 2.71.2 has the following issues:
* The WebSocket module may intermittently crash with an ArrayIndexOutOfBoundsException when the network connection is lost and then recovered, or when the app is moved to the background and then brought back to the foreground.
* Use Gamebase Android SDK 2.72.0, which has fixed this issue.

## 2.70.0

### Android
Expand Down
28 changes: 2 additions & 26 deletions ja/aos-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ AndroidでGamebaseを利用するためのシステム環境は、次の通り

> [最小仕様]
>
> * 使用者実行環境:Android API21 (Lollipop, OS 5.0)以上
> * ビルド環境:Android Gradle Plugin 4.0.1以上
> * 使用者実行環境:Android API22 (Lollipop MR1, OS 5.1)以上
> * ビルド環境:Android Gradle Plugin 7.4.2以上
> * 開発環境:Android Studio

### Dependencies
Expand All @@ -26,7 +26,6 @@ AndroidでGamebaseを利用するためのシステム環境は、次の通り
| | gamebase-adapter-auth-payco | payco-login-1.5.15 | Paycoログインをサポート | - |
| | gamebase-adapter-auth-twitter | - | Twitterログインをサポート | - |
| | gamebase-adapter-auth-weibo | sinaweibosdk.core-13.5.0 | Weiboログインをサポート | - |
| | gamebase-adapter-auth-weibo-v4 | openDefault-4.4.4 | Weiboログインをサポート | - |
| | gamebase-adapter-auth-kakaogame | kakaogame.idp_kakao-3.19.3<br>kakaogame.gamesdk-3.19.3<br>kakaogame.common-3.19.3<br>kakao.sdk.v2-auth-2.17.0<br>kakao.sdk.v2-partner-auth-2.17.0<br>kakao.sdk.v2-common-2.17.0<br>play-services-ads-identifier-17.0.0 | Kakaoログインをサポート | API 23(Marshmallow, OS 6.0) |
| | gamebase-adapter-auth-steam | - | Steamログインをサポート | API 25(Nougat, OS 7.1.1) |
| Gamebase IAP Adapters | gamebase-adapter-toastiap | toast-gamebase-iap-0.21.0<br>nhncloud-iap-core | ゲーム内決済をサポート | - |
Expand Down Expand Up @@ -177,10 +176,6 @@ dependencies {
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejp:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-hangamejpemail:$GAMEBASE_SDK_VERSION"
implementation "com.toast.android.gamebase:gamebase-adapter-auth-kakaogame:$GAMEBASE_SDK_VERSION"
// >>> [Weibo v4]
// https://github.com/nhn/toast.gamebase.android.sample/tree/main/weibo_sdk
implementation files('libs/openDefault-4.4.4.aar')
implementation "com.toast.android.gamebase:gamebase-adapter-auth-weibo-v4:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v16]
implementation "com.toast.android.gamebase:gamebase-adapter-purchase-onestore-v16:$GAMEBASE_SDK_VERSION"
// >>> [ONE store v17]
Expand All @@ -200,30 +195,11 @@ android {
// >>> [Purchase Support under Android 7.0(API Level 24)]
coreLibraryDesugaringEnabled true
}

defaultConfig {
// >>> [Weibo IdP]
ndk {
abiFilters 'armeabi' // , 'armeabi-v7a', 'arm64-v8a'
}
}
}
}
```

### Resources

#### Weibo IdP

* ビルドターゲットに応じて次のURLのsoファイルをダウンロードしてプロジェクトにコピーしてください。
* https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/so
* Android Studioビルドの場合
* プロジェクトのsrc/main/java/jniLibsフォルダの下にコピーします。
* ![Add so file to Android Studio project](https://static.toastoven.net/prod_gamebase/DevelopersGuide/aos-started-resources-weibo-so-android-studio-2.53.0.png)
* Unityビルドの場合
* soファイルとフォルダをAssets/Plugins/Android/libsフォルダの下にコピーします。
* ![Add so file to Unity project](https://static.toastoven.net/prod_gamebase/DevelopersGuide/aos-started-resources-weibo-so-unity-2.53.0.png)

#### Huawei Store

* AppGallery Connection構成ファイル(agconnect-services.json)をassetsフォルダに追加する必要があります。
Expand Down
2 changes: 1 addition & 1 deletion ja/ios-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
> 要件
>
> * ユーザー実行環境:iOS 12以上
> * ビルド環境:Xcode 15.0 (iOS 17 SDK)以上
> * ビルド環境:Xcode 16.0 (iOS 18 SDK)以上
>

<br/>
Expand Down
20 changes: 19 additions & 1 deletion ja/release-notes-android.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,30 @@
## Game > Gamebase > リリースノート > Android

### 2.73.0 (2025. 07. 15.)

[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.73.0/GamebaseSDK-Android.zip)

```
최소 지원 버전이 Android 5.1 이상으로 상향되었습니다.(minSdk 21 → 22)
Android Gradle Plugin 최소 버전이 7.4.2 이상으로 상향되었습니다.(4.0.1 -> 7.4.2)
```

#### 기능 개선/변경

* 내부 로직 개선

#### 버그 수정

* 로그인 웹뷰에서 화면 회전시 여백 크기를 잘못 계산하는 오류를 수정했습니다.

### 2.72.0 (2025. 06. 24.)

[SDK Download](https://static.toastoven.net/toastcloud/sdk_download/gamebase/v2.72.0/GamebaseSDK-Android.zip)

#### 기능 개선/변경

* 웹소켓 모듈이 중복 호출되는 경우 ArrayIndexOutOfBoundsException이 발생할 수 있는 로직 수정
* 웹소켓 모듈이 중복 호출되는 경우 ArrayIndexOutOfBoundsException이 발생할 수 있는 로직을 수정했습니다.
* 이 문제는 Gamebase Android SDK 2.71.2에서만 발생합니다.

#### 버그 수정

Expand Down
Loading