iTwin 移动端Demo

原创已于 2026-01-08 16:02:52 修改 · 618 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#iTwinjs

于 2026-01-08 16:02:04 首次发布

预处理

git clone https://github.com/iTwin/mobile-samples.git

git clone https://github.com/iTwin/mobile-sdk-core.git

git clone https://github.com/iTwin/mobile-sdk-android.git

git clone https://github.com/iTwin/mobile-ui-react.git

最后的目录是这样的

环境准备

1 申请ClientId

https://developer.bentley.com/my-apps/

com.bentley.sample.itwinstarter://app/signin-callback

com.bentley.sample.camera://app/signin-callback

com.bentley.sample.thirdpartyauth://app/signin-callback

2 properties 填写

拷贝example-ITMSamples.properties 重命名为ITMSamples.properties，

填写clientid和scope

3 npm 安装

readme提示必须是node 18 环境下（但是自己试本身20.14.0 也可）

4 申请个人Token

登录 GitHub
打开 github.com 并输入账号密码完成登录。
进入个人设置
点击右上角头像 → 下拉菜单里选择 Settings。
打开「开发者设置」
在左侧边栏最底部找到 Developer settings 并点击。
选择 PAT 类型
左侧菜单会出现两项：
- Personal access tokens → Tokens (classic)
- Personal access tokens → Fine-grained tokens
  一般 CLI、IDE、旧脚本用 classic 即可；如需按仓库/按权限精细化授权，则选 fine-grained。下面以更常见的 Tokens (classic) 为例。
新建 Token
点击右上角 Generate new token → Generate new token (classic)。
填写基本信息
- Note：给 Token 起个一眼能看懂的名字，例如 android-studio-push。
- Expiration：建议选 30/60/90 天或自定义，最长 1 年；到期可再建。
- Select scopes（权限）：write package和read package 要加上
生成并立即复制
页面底部点击 Generate token。
下一页会出现一串以 ghp_ 开头的大段字符——只显示一次。
点击右侧复制图标，把它先粘到安全的地方（密码管理器或加密笔记），离开此页面后就再也看不到这串 Token 了。

5 运行

1 本地构建 `mobile-ui-react` 依赖项

cd mobile-ui-react

npm install

npm run build

2 更新依赖项并编译

cd ../mobile-samples/cross-platform/react-app

npx relative-deps

npm i

npm run build

3 构建 iTwinStarter

1. **创建属性文件**：

将 `Android/Shared/example-ITMSamples.properties` 复制为 `Android/Shared/ITMSamples.properties`。

2. **编辑 `ITMSamples.properties`**：

* 配置 OIDC 设置（Client ID, Scope 等）。

* （开发可选）设置 `itm.debug_use_ip=YES`。

3. **Local Properties**：

确保 `mobile-samples/Android/iTwinStarter/local.properties` 也包含配置的 `gpr.key`。

4 实际运行修改的地方:

iTwin Starter build.gradle中直接添加

afterEvaluate {

    if (tasks.findByName('testDebugUnitTest')) {

        tasks.register('testClasses') { dependsOn 'testDebugUnitTest' }

    }

}

在 Android Studio 中打开 `mobile-samples/Android/iTwinStarter`，

编译并打开手机开发者模式通过USB链接手机

华为手机是：点击10几下HarmonyOS 版本进入

注意：本地debug模式可能模拟器会出现闪退现象，可能和防火墙之类的相关，还未排查