app-starlock/README.md

# 星锁APP
测试ci
星云项目组旗下的智能锁应用，其中锁相关数据接入星云平台，业务数据接入星锁自有后台。

基于Flutter技术架构，支持Android和iOS平台。

## 开发步骤

### 安装Flutter

参阅 [安装 - Flutter](https://docs.flutter.dev/get-started/install)

然后 `flutter doctor` 检查环境

### 禁用不需要的平台

```bash
flutter config --no-enable-macos-desktop --no-enable-windows-desktop --no-enable-linux-desktop --no-enable-web
```


### 安装依赖

```bash
flutter pub get
```

### 运行

```bash

# 运行sky渠道
flutter run --flavor sky -t lib/main_sky_full.dart

```

## 配置签名

参阅 [构建和发布 Android 应用 - 创建上载密钥库 - Flutter](https://docs.flutter.dev/deployment/android#create-an-upload-keystore)

为发布渠道创建JAVA密钥储存(密钥库)文件 `.jks`，或者 `.keystore` 文件。

```bash
keytool -genkey -v -keystore android/app/sky.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
```

请记住你输入的主密码和键密码

因为本项目将会发布2个以上的渠道，所以密钥库也会有2个以上，请注意区分 同一个发布渠道必须使用同一个密钥库，不要生成多个。

为了编译管理方便，我们将密钥库文件放在了项目代码内。

`key.properties` 文件用于存放密钥库的相关信息，但是我们不用这个文件，而是直接在 `build.gradle` 中写入密钥库的相关信息。
因为我们将密钥库文件本身都已经储存在git中了，也就没必要再单独存放密钥信息了。

## 获取密钥库证书指纹
一般用于SDK的应用创建里面填写的资料，例如高德SDK

```bash
keytool -list -v -keystore android/app/sky.jks
```

输入密码（在android/app/build.gradle:38可以看到）
测试ci
一般需要的是：证书指纹-SHA1 看起来像 95:6B:***********（共59个字符）

## 编译
```bash
flutter build apk --release --flavor sky -t lib/main_sky_full.dart
```
编译后的包：
通用：build/app/outputs/apk/sky/release/app-sky-universal-release.apk
32位：build/app/outputs/apk/sky/release/app-sky-armeabi-v7a-release.apk
64位：build/app/outputs/apk/sky/release/app-sky-arm64-v8a-release.apk

注意修改“VersionCode”为版本代码
```bash
cp build/app/outputs/apk/sky/release/app-sky-armeabi-v7a-release.apk /d/www/SkyReleases/app-sky-32-release-VersionCode.apk
cp build/app/outputs/apk/sky/release/app-sky-arm64-v8a-release.apk /d/www/SkyReleases/app-sky-64-release-VersionCode.apk
cp build/app/outputs/apk/sky/release/app-sky-universal-release.apk /d/www/SkyReleases/app-sky-universal-release-VersionCode.apk
```
## 获取编译包的签名
用于APP备案，国内商店上架等

需要使用到`apksigner`工具，对于Windows来说，它在：`C:\Users\myUser\AppData\Local\Android\Sdk\build-tools\34.0.0\lib`

在 `git bash` 中我需要使用 `apksigner.bat` 来使用它；在其它系统中应该可以直接使用 `apksigner` 命令即可。

参阅：[How to find signature of apk file?](https://stackoverflow.com/questions/38558623/how-to-find-signature-of-apk-file)

```bash
apksigner verify --print-certs -v build/app/outputs/flutter-apk/app-sky-release.apk
```


## 用于Google Play发布的指南
https://www.gstatic.com/play-apps-publisher-rapid/signing-tool/prod/pepk-src.jar
1. 下载 Play Encrypt Private Key (PEPK) 工具，请注意 [pepk-src.jar中没有主清单属性](https://stackoverflow.com/questions/44719351/googles-pepk-src-not-working)
2. 生成密钥
```bash
java -jar android/google/pepk.jar --keystore=android/app/sky.jks --alias=upload --output=android/google/google_pek.zip --include-cert --rsa-aes-encryption --encryption-key-path=android/google/encryption_public_key.pem
```
3. 上传密钥
上传android/google/google_pek.zip文件到谷歌Play管理中心
4. 编译和上传 app bundle
```bash
flutter build appbundle --release --flavor sky -t lib/main_sky.dart
```
编译后的包：`build/app/outputs/bundle/skyRelease/app-sky-release.aab`
注意修改“VersionCode”为版本代码
```bash
cp build/app/outputs/bundle/skyRelease/app-sky-release.aab /d/www/SkyReleases/app-sky-release-VersionCode.aab
```
- 注意，这里的sky.jks和google_pek.zip和encryption_public_key.pem都是sky渠道的，和谷歌账号对应。如果需要使用其他谷歌账号，需要更换这两个文件。

## 用于华为商店
1. 复制谷歌的 (PEPK) 工具
2. 生成密钥
```bash
java -jar android/huawei/pepk.jar --keystore=android/app/sky.jks --alias=upload --output=android/huawei/huawei_pek.zip --encryptionkey=034200041E224EE22B45D19B23DB91BA9F52DE0A06513E03A5821409B34976FDEED6E0A47DBA48CC249DD93734A6C5D9A0F43461F9E140F278A5D2860846C2CF5D2C3C02 --include-cert
```
3. 上传密钥
4. 编译和上传 app bundle，和谷歌的一样编译出aab文件即可

## 用于app store

下载flavor模板文件，这会创建.tmp文件夹，只需要执行一次，如果有.tmp文件夹，就不用执行这一步了
```bash
dart run flutter_flavorizr -p assets:download
dart run flutter_flavorizr -p assets:extract
```
重新生成Generated.xcconfig以更新购建物版本号等信息
```bash
flutter build ios --config-only --flavor sky
```
构建/编译
```bash
在Xcode中选择菜单 Product->archive
```
准备截图
因为模拟器只能运行debug，而不能运行release和profile，所以要修改以下运行配置：
Xcode顶部中间设备选择器左边，Runner选择下拉，选择Edit Scheme，左侧选择Run，右侧的Build Configuration选择Debug-sky
选择Runner：sky-debug 运行于模拟器

6.5寸（1242 x 2688px）截图选择机型：iphone 11 Pro Max（ios17）
5.5寸（1242 x 2208px）截图选择机型：iphone 8 Plus（ios15） （此项目在这个机型会崩溃，无法运行）

截图完成记得将Runner改回去，不然编译出来的sky是debug版的。

最后还是随便截图的，然后用PS裁剪成要求的分辨率上传了


## 用于aab文件转apk

安装bundletool.jar(该文件在git忽略，每个机器需要自行下载)
```bash
wget -o android/bundletool.jar https://github.com/google/bundletool/releases/download/1.15.6/bundletool-all-1.15.6.jar
```

将aab转为apk
```bash
java -jar android/bundletool.jar build-apks --bundle=build/app/outputs/bundle/skyRelease/app-sky-release.aab \
--output=build/app/outputs/bundle/skyRelease/app-sky-release.aab.apks \
--ks=android/app/sky.jks \
--ks-pass=pass:sky2028 \
--ks-key-alias=upload \
--key-pass=pass:sky2028 
```

安装apks文件到手机
```bash
java -jar android/bundletool.jar install-apks --apks=build/app/outputs/bundle/skyRelease/app-sky-release.aab.apks
```

## Jpush相关

极光推送，目前app这边只依赖极光的透传能力，推送能力通过截取极光拿到的各个厂商的推送token，然后将推送token上报到自己业务服务器直接调用各个厂商推送通道进行消息推送，所以对极光的flutter sdk进行了私有化定制改造，改造点如下：

* Android，iOS平台原生代码中截取jpush获取到的厂商推送token，将token回传到flutter业务应用层
  * Android通过Jpush统一集成的各个厂商推送sdk，统一获取到token
  * iOS通过原生token回调接口获取到token
* flutter端，将获取到的厂商token，厂商标识上报到业务服务器

定制jpush_flutter：http://code-internal.star-lock.cn/StarlockTeam/jpush_flutter