Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/quick-starts/framework/android/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Assuming you treat `io.logto.android` as the custom `LOGTO_REDIRECT_SCHEME`, and

<Tabs groupId="android-sdk-version">

<TabItem default value="v3" label="v3 (beta)">
<TabItem default value="v3" label="v3">

In v3, the sign-in experience opens in a [Custom Tab](https://developer.android.com/develop/ui/views/layout/webapps/overview-of-android-custom-tabs) (the system browser), and the redirect is routed back to your app through an OS-level intent filter. You need to declare the scheme of your redirect URI with the `logtoRedirectScheme` manifest placeholder in your app's build file:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ You can use `logtoClient.signIn` to sign in the user and `logtoClient.signOut` t

<Tabs groupId="android-sdk-version">

<TabItem default value="v3" label="v3 (beta)">
<TabItem default value="v3" label="v3">

In v3, `logtoClient.signOut` performs a complete sign-out: it clears the local credentials, revokes the refresh token, and ends the Logto session by opening the end session endpoint in the browser. The browser then navigates back to your app through the post sign-out redirect URI. Before using it, switch to the application details page of Logto Console, add the post sign-out redirect URI `io.logto.android://io.logto.sample/callback` and click "Save changes". The post sign-out redirect URI follows the same pattern as the redirect URI, and its scheme must also match the `logtoRedirectScheme` manifest placeholder.

Expand Down
10 changes: 5 additions & 5 deletions docs/quick-starts/framework/android/_installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ The minimum supported Android API level of Logto Android SDK is level 24.

Logto Android SDK comes in two major versions:

- **v3 (beta)**: Opens the sign-in experience in [Chrome Custom Tabs](https://developer.android.com/develop/ui/views/layout/webapps/overview-of-android-custom-tabs) (the system browser), which unlocks passkey sign-in and shares the browser session. Note that v3 removes support for the <MainSiteUrl href="/integrations/wechat-native">WeChat (Native)</MainSiteUrl> and <MainSiteUrl href="/integrations/alipay-native">Alipay (Native)</MainSiteUrl> connectors; you can use <MainSiteUrl href="/integrations/wechat-web">WeChat (Web)</MainSiteUrl> and <MainSiteUrl href="/integrations/alipay-web">Alipay (Web)</MainSiteUrl> instead, which work through the browser. If you depend on the native connectors, stay on v2.
- **v3**: Opens the sign-in experience in [Chrome Custom Tabs](https://developer.android.com/develop/ui/views/layout/webapps/overview-of-android-custom-tabs) (the system browser), which unlocks passkey sign-in and shares the browser session. Note that v3 removes support for the <MainSiteUrl href="/integrations/wechat-native">WeChat (Native)</MainSiteUrl> and <MainSiteUrl href="/integrations/alipay-native">Alipay (Native)</MainSiteUrl> connectors; you can use <MainSiteUrl href="/integrations/wechat-web">WeChat (Web)</MainSiteUrl> and <MainSiteUrl href="/integrations/alipay-web">Alipay (Web)</MainSiteUrl> instead, which work through the browser. If you depend on the native connectors, stay on v2.
- **v2**: Opens the sign-in experience in an embedded WebView, which is required by the native social connectors, but does not support <MainSiteUrl href="/end-user-flows/sign-up-and-sign-in/passkey-sign-in">passkey sign-in</MainSiteUrl> (WebView does not support WebAuthn, the underlying standard of passkeys).

This guide covers both versions. Choose your version in the tabs below, and the choice will be kept in sync throughout this guide.
Expand All @@ -26,17 +26,17 @@ Add Logto Android SDK to your dependencies:

<Tabs groupId="android-sdk-version">

<TabItem default value="v3" label="v3 (beta)">
<TabItem default value="v3" label="v3">

v3 is released as `3.0.0-beta` prereleases until GA. Use the latest prerelease as the version:
Use the latest v3 release as the version:

<Tabs>

<TabItem value="kotlin" label="Kotlin">

```kotlin title="build.gradle.kts"
dependencies {
implementation("io.logto.sdk:android:3.0.0-beta")
implementation("io.logto.sdk:android:3.0.0")
}
```

Expand All @@ -46,7 +46,7 @@ dependencies {

```groovy title="build.gradle"
dependencies {
implementation 'io.logto.sdk:android:3.0.0-beta'
implementation 'io.logto.sdk:android:3.0.0'
}
```

Expand Down
10 changes: 5 additions & 5 deletions docs/quick-starts/framework/swift/_add-sdk.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ The minimum supported iOS version of Logto Swift SDK is iOS 13.

Logto Swift SDK comes in two major versions:

- **v2**: Opens the sign-in experience in [`ASWebAuthenticationSession`](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession) (the system browser), which unlocks passkey sign-in and shares the browser session. Note that v2 removes the native social plugin targets; social connectors still work through the browser. If you depend on the native WeChat or Alipay SDK handoff, stay on v1.
- **v1**: Opens the sign-in experience in an embedded WebView, which is required by the native social plugin targets, but does not support <MainSiteUrl href="/end-user-flows/sign-up-and-sign-in/passkey-sign-in">passkey sign-in</MainSiteUrl> (WebView does not support WebAuthn, the underlying standard of passkeys).
- **v2 (beta)**: Opens the sign-in experience in [`ASWebAuthenticationSession`](https://developer.apple.com/documentation/authenticationservices/aswebauthenticationsession) (the system browser), which unlocks passkey sign-in and shares the browser session. Note that v2 removes the native social plugin targets; social connectors still work through the browser. If you depend on the native WeChat or Alipay SDK handoff, stay on v1.

This guide covers both versions. Choose your version in the tabs below, and the choice will be kept in sync throughout this guide.

Expand All @@ -24,21 +24,21 @@ When Xcode asks for the package version, choose the version you want to integrat

<Tabs groupId="swift-sdk-version" defaultValue="v2">

<TabItem value="v2" label="v2 (beta)">
<TabItem value="v2" label="v2">

v2 is released as `2.0.0-beta.x` prereleases until GA. Use `2.0.0-beta.1` or the latest `2.0.0-beta.x` prerelease as the version. During beta, we recommend selecting the prerelease explicitly instead of relying on a normal version range to pick it automatically.
Use the latest v2 release as the version. The latest v2 version is `2.0.0`.

If you use `Package.swift` directly:

```swift title="Package.swift"
.package(url: "https://github.com/logto-io/swift.git", exact: "2.0.0-beta.1")
.package(url: "https://github.com/logto-io/swift.git", from: "2.0.0")
```

</TabItem>

<TabItem value="v1" label="v1">

Use the latest v1 release as the stable line. The latest v1 version is `1.2.0`.
Use the latest v1 release if you need the native social plugin targets. The latest v1 version is `1.2.0`.

If you use `Package.swift` directly:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ import SignInFlowSummary from '../../fragments/_web-sign-in-flow-summary.mdx';

<Tabs groupId="swift-sdk-version" defaultValue="v2">

<TabItem value="v2" label="v2 (beta)">
<TabItem value="v2" label="v2">

<ConfigureRedirectUri
figureSrc="/img/assets/ios-redirect-uri.png"
Expand Down Expand Up @@ -83,7 +83,7 @@ The Redirect URI in iOS SDK is only for internal use. There's _NO NEED_ to add a

<Tabs groupId="swift-sdk-version" defaultValue="v2">

<TabItem value="v2" label="v2 (beta)">
<TabItem value="v2" label="v2">

In v2, `client.signOut(postLogoutRedirectUri:)` performs a complete sign-out: it clears the local credentials, revokes the refresh token, and ends the Logto session by opening the end session endpoint in the system browser. The browser then navigates back to your app through the post sign-out redirect URI. Before using it, switch to the application details page of Logto Console, add the post sign-out redirect URI `io.logto.app://signed-out` and click "Save changes". The post sign-out redirect URI can use the same custom scheme you registered for sign-in.

Expand Down
Loading