快速开始

相关资料

• Android SDK Github
• Android demo 源码

Android demo

请前往 Google drive 下载 Android demo 安装包：

• unipass_android_demo_v0.0.3.apk

提示

Demo 工程中使用的 UniPass Wallet 域名: https://testnet.wallet.unipass.id/

开发环境

Android API 21 或以上版本

安装和使用

1. 在您的项目的 settings.gradle 或 build.gradle 文件中, 添加 JitPack repository：

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }  // 添加本行
  }
}

2. 在 build.gradle 添加依赖：

dependencies {
    implementation 'com.github.UniPassID:UniPass-Android-SDK:{Version}' // 请将 {Version} 替换为你需要的 SDK 版本
}

3. 添加 UniPassActivity 并配置深层链接 (Deep Link)

在 app 的 AndroidManifest.xml 文件中添加 UniPassActivity， 并对 UniPassActivity 配置指向您应用的深层链接，具体配置可以参考 android developer 文档

<activity
    android:name="com.unipass.core.UniPassActivity"
    android:exported="true"
    android:launchMode="singleTop">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accept URIs: {YOUR_APP_PACKAGE_NAME}://* -->
        <data android:scheme="{YOUR_APP_PACKAGE_NAME}" />
        <!-- 以下配置可以供您参考 -->
        <data
            android:scheme="unipassapp"
            android:host="com.unipass.wallet"
            android:pathPattern="/*"
            android:pathPrefix="/redirect" />
    </intent-filter>
</activity>

如果您使用 v0.0.3 或以下版本，您可以无需在应用中添加 UniPassActivity ，但需要在您使用 SDK 的活动中配置深层链接（Deep Link），并确保 app 配置文件 AndroidManifest.xml 中您应用的 launchMode 已被设置为 singleTop

<activity
  android:launchMode="singleTop"
  android:name=".YourActivity">
  // ...
</activity>

4. 最后在您的 Java/Kotlin 代码中使用：

import com.unipass.core.UniPassSDK

请在您的 Manifest file 文件中查看网络权限是否开启： <uses-permission android:name="android.permission.INTERNET" />

历史版本

更新版本	更新日期	默认使用 Domain	更新说明
v0.0.15	2023.04.13	https://testnet.wallet.unipass.id/	login api 添加 forceLogin 参数，默认为 false
v0.0.14	2023.03.28	https://testnet.wallet.unipass.id/	修复当前登录用户与签名/交易时站点登录用户不一致时导致的问题
v0.0.13	2023.03.14	https://testnet.wallet.unipass.id/	兼容性优化；移除对 web3j 的依赖；优化对 UnipassActivity 的处理
v0.0.12	2023.03.09	https://testnet.wallet.unipass.id/	代码优化, 移除所有 lateinit 变量
v0.0.11	2023.02.07	https://testnet.wallet.unipass.id/	login 方法将 connectType 参数迁移到 loginOption, 并增加 returnEmail, authorize 等选项
v0.0.10	2023.02.06	https://testnet.wallet.unipass.id/	login 方法增加可选参数 loginOption
v0.0.9	2023.01.29	https://testnet.wallet.unipass.id/	logout 方法增加可选参数 deep，设置为 false 时，登出时可以保留网页端登陆状态
v0.0.8	2023.01.29	https://testnet.wallet.unipass.id/	支持 minifyEnable 构建
v0.0.7	2023.01.15	https://testnet.wallet.unipass.id/	代码优化：用户 关闭浏览器/打断进程 时抛出中断异常
v0.0.6	2023.01.13	https://testnet.wallet.unipass.id/	新增重载 API login, 支持可选链接方式。代码实现优化
v0.0.5	2023.01.09	https://testnet.wallet.unipass.id/	新增 UniPassActivity , 取消对 activity singleTop launchMode 的限制。UniPassSDKOptions 新增入参: activity
v0.0.3	2023.01.04	https://testnet.wallet.unipass.id/	支持连接钱包，转账代币，签名功能，登出