diff --git a/package.json b/package.json
index 6759974..d4d6ed9 100644
--- a/package.json
+++ b/package.json
@@ -7,6 +7,9 @@
"dev": "vite --host",
"build": "pnpm run type-check:publish && vite build",
"build:zip": "pnpm run build && powershell -NoProfile -Command \"New-Item -ItemType Directory -Force -Path release | Out-Null; Compress-Archive -Path dist\\* -DestinationPath release\\gao-customer-h5.zip -Force\"",
+ "twa:build": "cd twa && pnpm --config.registry=https://registry.npmjs.org dlx @bubblewrap/cli@1.25.0 build --manifest=./twa-manifest.json",
+ "twa:update": "cd twa && pnpm --config.registry=https://registry.npmjs.org dlx @bubblewrap/cli@1.25.0 update --skipVersionUpgrade --manifest=./twa-manifest.json",
+ "twa:validate": "pnpm --config.registry=https://registry.npmjs.org dlx @bubblewrap/cli@1.25.0 validate --url=https://gao.imyeyu.com/",
"preview": "vite preview",
"lint": "eslint . --ext .ts,.vue",
"type-check": "vue-tsc -p tsconfig.app.json --noEmit",
diff --git a/public/.well-known/assetlinks.json b/public/.well-known/assetlinks.json
new file mode 100644
index 0000000..efa3990
--- /dev/null
+++ b/public/.well-known/assetlinks.json
@@ -0,0 +1,12 @@
+[
+ {
+ "relation": ["delegate_permission/common.handle_all_urls"],
+ "target": {
+ "namespace": "android_app",
+ "package_name": "com.imyeyu.gao.customer",
+ "sha256_cert_fingerprints": [
+ "EF:65:BA:62:7D:E3:1C:D3:BD:C7:D9:1D:6A:69:35:81:56:87:DF:03:0D:E7:76:27:94:90:5E:CC:F4:45:02:69"
+ ]
+ }
+ }
+]
diff --git a/public/manifest.webmanifest b/public/manifest.webmanifest
index 16cdf94..b03200b 100644
--- a/public/manifest.webmanifest
+++ b/public/manifest.webmanifest
@@ -1,11 +1,13 @@
{
- "name": "Gao Customer H5",
- "short_name": "Gao H5",
+ "id": "/",
+ "name": "糕店客户管理",
+ "short_name": "糕店管理",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#ffffff",
"start_url": "/",
"scope": "/",
+ "orientation": "portrait",
"icons": [
{
"src": "/icons/icon-192.png",
diff --git a/twa/.gitignore b/twa/.gitignore
new file mode 100644
index 0000000..b0326bb
--- /dev/null
+++ b/twa/.gitignore
@@ -0,0 +1,10 @@
+.gradle/
+local.properties
+**/build/
+*.apk
+*.aab
+*.idsig
+*.jks
+*.keystore
+
+!gradle/wrapper/gradle-wrapper.jar
diff --git a/twa/README.md b/twa/README.md
new file mode 100644
index 0000000..74c54f7
--- /dev/null
+++ b/twa/README.md
@@ -0,0 +1,41 @@
+# TWA 构建说明
+
+本目录是 `gao.imyeyu.com` 的 Trusted Web Activity 工程。APK 只包含 Android 启动壳，业务页面始终从 `https://gao.imyeyu.com/` 加载，不把前端 `dist` 打进 APK。
+
+## 构建环境
+
+- JDK 17
+- Android SDK
+- Bubblewrap CLI 1.25.0
+
+在本机首次使用 Bubblewrap 时执行：
+
+```powershell
+pnpm --config.registry=https://registry.npmjs.org dlx @bubblewrap/cli@1.25.0 doctor
+```
+
+## 构建 APK
+
+首次构建正式版本时，先在本目录生成并妥善备份 release keystore：
+
+```powershell
+keytool -genkeypair -v -keystore .\android.keystore -alias gao-customer -keyalg RSA -keysize 2048 -validity 10000
+```
+
+```powershell
+pnpm --config.registry=https://registry.npmjs.org dlx @bubblewrap/cli@1.25.0 build
+```
+
+构建前请准备长期保存的 release keystore，并确认 `twa-manifest.json` 中的 `signingKey` 指向它。当前目录的 `signingKey` 是可提交的相对路径模板；本次验证 APK 使用的是本机调试签名，不能作为正式发布签名。
+
+构建完成后，用 release keystore 的 SHA-256 证书指纹更新 `../public/.well-known/assetlinks.json`，再发布前端 `dist`。TWA 只有在网站的 `/.well-known/assetlinks.json` 与 APK 包名、签名一致时，才会进入无地址栏的全屏模式。
+
+当前 `assetlinks.json` 中登记的是本机调试证书指纹，只能配合本次验证 APK 使用。正式发布前必须替换为 release 证书指纹；如果使用 Google Play，还要把 Play App Signing 证书指纹一并登记。
+
+## 前端发布顺序
+
+1. 先上传新版本 `dist/assets`。
+2. 再上传新的 `index.html`、Manifest 和其他静态文件。
+3. 最后检查 `https://gao.imyeyu.com/`、`/manifest.webmanifest` 和 `/.well-known/assetlinks.json`。
+
+`index.html` 不缓存，带哈希的 `/assets/` 长缓存。不要给前端资源增加 Service Worker 缓存，除非同时实现版本更新和回滚，否则会阻止 TWA 获取最新页面。
diff --git a/twa/app/build.gradle b/twa/app/build.gradle
new file mode 100644
index 0000000..a78f726
--- /dev/null
+++ b/twa/app/build.gradle
@@ -0,0 +1,213 @@
+/*
+ * Copyright 2019 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import groovy.xml.MarkupBuilder
+
+plugins {
+ id 'com.android.application'
+}
+
+def twaManifest = [
+ applicationId: 'com.imyeyu.gao.customer',
+ hostName: 'gao.imyeyu.com', // The domain being opened in the TWA.
+ launchUrl: '/', // The start path for the TWA. Must be relative to the domain.
+ name: '糕店客户管理', // The application name.
+ launcherName: '糕店管理', // The name shown on the Android Launcher.
+ themeColor: '#FFFFFF', // The color used for the status bar.
+ themeColorDark: '#000000', // The color used for the dark status bar.
+ navigationColor: '#000000', // The color used for the navigation bar.
+ navigationColorDark: '#000000', // The color used for the dark navbar.
+ navigationDividerColor: '#000000', // The navbar divider color.
+ navigationDividerColorDark: '#000000', // The dark navbar divider color.
+ backgroundColor: '#FFFFFF', // The color used for the splash screen background.
+ enableNotifications: false, // Set to true to enable notification delegation.
+ // Every shortcut must include the following fields:
+ // - name: String that will show up in the shortcut.
+ // - short_name: Shorter string used if |name| is too long.
+ // - url: Absolute path of the URL to launch the app with (e.g '/create').
+ // - icon: Name of the resource in the drawable folder to use as an icon.
+ shortcuts: [],
+ // The duration of fade out animation in milliseconds to be played when removing splash screen.
+ splashScreenFadeOutDuration: 300,
+ generatorApp: 'bubblewrap-cli', // Application that generated the Android Project
+ // The fallback strategy for when Trusted Web Activity is not available. Possible values are
+ // 'customtabs' and 'webview'.
+ fallbackType: 'customtabs',
+ enableSiteSettingsShortcut: 'true',
+ orientation: 'portrait',
+]
+
+android {
+ compileSdkVersion 36
+ namespace "com.imyeyu.gao.customer"
+ defaultConfig {
+ applicationId "com.imyeyu.gao.customer"
+ minSdkVersion 21
+ targetSdkVersion 36
+ versionCode 1
+ versionName "1"
+
+ // The name for the application
+ resValue "string", "appName", twaManifest.name
+
+ // The name for the application on the Android Launcher
+ resValue "string", "launcherName", twaManifest.launcherName
+
+ // The URL that will be used when launching the TWA from the Android Launcher
+ def launchUrl = "https://" + twaManifest.hostName + twaManifest.launchUrl
+ resValue "string", "launchUrl", launchUrl
+
+
+
+
+ // The URL the Web Manifest for the Progressive Web App that the TWA points to. This
+ // is used by Chrome OS and Meta Quest to open the Web version of the PWA instead of
+ // the TWA, as it will probably give a better user experience for non-mobile devices.
+ resValue "string", "webManifestUrl", 'https://gao.imyeyu.com/manifest.webmanifest'
+
+
+
+ // This is used by Meta Quest.
+ resValue "string", "fullScopeUrl", 'https://gao.imyeyu.com/'
+
+
+
+
+ // The hostname is used when building the intent-filter, so the TWA is able to
+ // handle Intents to open host url of the application.
+ resValue "string", "hostName", twaManifest.hostName
+
+ // This attribute sets the status bar color for the TWA. It can be either set here or in
+ // `res/values/colors.xml`. Setting in both places is an error and the app will not
+ // compile. If not set, the status bar color defaults to #FFFFFF - white.
+ resValue "color", "colorPrimary", twaManifest.themeColor
+
+ // This attribute sets the dark status bar color for the TWA. It can be either set here or in
+ // `res/values/colors.xml`. Setting in both places is an error and the app will not
+ // compile. If not set, the status bar color defaults to #000000 - white.
+ resValue "color", "colorPrimaryDark", twaManifest.themeColorDark
+
+ // This attribute sets the navigation bar color for the TWA. It can be either set here or
+ // in `res/values/colors.xml`. Setting in both places is an error and the app will not
+ // compile. If not set, the navigation bar color defaults to #FFFFFF - white.
+ resValue "color", "navigationColor", twaManifest.navigationColor
+
+ // This attribute sets the dark navigation bar color for the TWA. It can be either set here
+ // or in `res/values/colors.xml`. Setting in both places is an error and the app will not
+ // compile. If not set, the navigation bar color defaults to #000000 - black.
+ resValue "color", "navigationColorDark", twaManifest.navigationColorDark
+
+ // This attribute sets the navbar divider color for the TWA. It can be either
+ // set here or in `res/values/colors.xml`. Setting in both places is an error and the app
+ // will not compile. If not set, the divider color defaults to #00000000 - transparent.
+ resValue "color", "navigationDividerColor", twaManifest.navigationDividerColor
+
+ // This attribute sets the dark navbar divider color for the TWA. It can be either
+ // set here or in `res/values/colors.xml`. Setting in both places is an error and the
+ //app will not compile. If not set, the divider color defaults to #000000 - black.
+ resValue "color", "navigationDividerColorDark", twaManifest.navigationDividerColorDark
+
+ // Sets the color for the background used for the splash screen when launching the
+ // Trusted Web Activity.
+ resValue "color", "backgroundColor", twaManifest.backgroundColor
+
+ // Defines a provider authority for the Splash Screen
+ resValue "string", "providerAuthority", twaManifest.applicationId + '.fileprovider'
+
+ // The enableNotification resource is used to enable or disable the
+ // TrustedWebActivityService, by changing the android:enabled and android:exported
+ // attributes
+ resValue "bool", "enableNotification", twaManifest.enableNotifications.toString()
+
+ twaManifest.shortcuts.eachWithIndex { shortcut, index ->
+ resValue "string", "shortcut_name_$index", "$shortcut.name"
+ resValue "string", "shortcut_short_name_$index", "$shortcut.short_name"
+ }
+
+ // The splashScreenFadeOutDuration resource is used to set the duration of fade out animation in milliseconds
+ // to be played when removing splash screen. The default is 0 (no animation).
+ resValue "integer", "splashScreenFadeOutDuration", twaManifest.splashScreenFadeOutDuration.toString()
+
+ resValue "string", "generatorApp", twaManifest.generatorApp
+
+ resValue "string", "fallbackType", twaManifest.fallbackType
+
+ resValue "bool", "enableSiteSettingsShortcut", twaManifest.enableSiteSettingsShortcut
+ resValue "string", "orientation", twaManifest.orientation
+
+
+ }
+ buildTypes {
+ release {
+ minifyEnabled true
+ }
+ }
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+ lintOptions {
+ checkReleaseBuilds false
+ }
+}
+
+task generateShorcutsFile {
+ assert twaManifest.shortcuts.size() < 5, "You can have at most 4 shortcuts."
+ twaManifest.shortcuts.eachWithIndex { s, i ->
+ assert s.name != null, 'Missing `name` in shortcut #' + i
+ assert s.short_name != null, 'Missing `short_name` in shortcut #' + i
+ assert s.url != null, 'Missing `icon` in shortcut #' + i
+ assert s.icon != null, 'Missing `url` in shortcut #' + i
+ }
+
+ def shortcutsFile = new File("$projectDir/src/main/res/xml", "shortcuts.xml")
+
+ def xmlWriter = new StringWriter()
+ def xmlMarkup = new MarkupBuilder(new IndentPrinter(xmlWriter, " ", true))
+
+ xmlMarkup
+ .'shortcuts'('xmlns:android': 'http://schemas.android.com/apk/res/android') {
+ twaManifest.shortcuts.eachWithIndex { s, i ->
+ 'shortcut'(
+ 'android:shortcutId': 'shortcut' + i,
+ 'android:enabled': 'true',
+ 'android:icon': '@drawable/' + s.icon,
+ 'android:shortcutShortLabel': '@string/shortcut_short_name_' + i,
+ 'android:shortcutLongLabel': '@string/shortcut_name_' + i) {
+ 'intent'(
+ 'android:action': 'android.intent.action.MAIN',
+ 'android:targetPackage': twaManifest.applicationId,
+ 'android:targetClass': twaManifest.applicationId + '.LauncherActivity',
+ 'android:data': s.url)
+ 'categories'('android:name': 'android.intent.category.LAUNCHER')
+ }
+ }
+ }
+ shortcutsFile.text = xmlWriter.toString() + '\n'
+}
+
+preBuild.dependsOn(generateShorcutsFile)
+
+repositories {
+
+}
+
+dependencies {
+ implementation fileTree(include: ['*.jar'], dir: 'libs')
+
+ implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.6.2'
+
+}
diff --git a/twa/app/src/main/AndroidManifest.xml b/twa/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..7b28ccb
--- /dev/null
+++ b/twa/app/src/main/AndroidManifest.xml
@@ -0,0 +1,192 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/twa/app/src/main/java/com/imyeyu/gao/customer/Application.java b/twa/app/src/main/java/com/imyeyu/gao/customer/Application.java
new file mode 100644
index 0000000..47dbe27
--- /dev/null
+++ b/twa/app/src/main/java/com/imyeyu/gao/customer/Application.java
@@ -0,0 +1,29 @@
+/*
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.imyeyu.gao.customer;
+
+
+
+public class Application extends android.app.Application {
+
+
+
+ @Override
+ public void onCreate() {
+ super.onCreate();
+
+ }
+}
diff --git a/twa/app/src/main/java/com/imyeyu/gao/customer/DelegationService.java b/twa/app/src/main/java/com/imyeyu/gao/customer/DelegationService.java
new file mode 100644
index 0000000..20fbfc2
--- /dev/null
+++ b/twa/app/src/main/java/com/imyeyu/gao/customer/DelegationService.java
@@ -0,0 +1,14 @@
+package com.imyeyu.gao.customer;
+
+
+
+public class DelegationService extends
+ com.google.androidbrowserhelper.trusted.DelegationService {
+ @Override
+ public void onCreate() {
+ super.onCreate();
+
+
+ }
+}
+
diff --git a/twa/app/src/main/java/com/imyeyu/gao/customer/LauncherActivity.java b/twa/app/src/main/java/com/imyeyu/gao/customer/LauncherActivity.java
new file mode 100644
index 0000000..4c0b375
--- /dev/null
+++ b/twa/app/src/main/java/com/imyeyu/gao/customer/LauncherActivity.java
@@ -0,0 +1,54 @@
+/*
+ * Copyright 2020 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.imyeyu.gao.customer;
+
+import android.content.pm.ActivityInfo;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+
+
+
+public class LauncherActivity
+ extends com.google.androidbrowserhelper.trusted.LauncherActivity {
+
+
+
+
+ @Override
+ protected void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ // Setting an orientation crashes the app due to the transparent background on Android 8.0
+ // Oreo and below. We only set the orientation on Oreo and above. This only affects the
+ // splash screen and Chrome will still respect the orientation.
+ // See https://github.com/GoogleChromeLabs/bubblewrap/issues/496 for details.
+ if (Build.VERSION.SDK_INT > Build.VERSION_CODES.O) {
+ setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_USER_PORTRAIT);
+ } else {
+ setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED);
+ }
+ }
+
+ @Override
+ protected Uri getLaunchingUrl() {
+ // Get the original launch Url.
+ Uri uri = super.getLaunchingUrl();
+
+
+
+ return uri;
+ }
+}
diff --git a/twa/app/src/main/res/drawable-anydpi/shortcut_legacy_background.xml b/twa/app/src/main/res/drawable-anydpi/shortcut_legacy_background.xml
new file mode 100644
index 0000000..d53c148
--- /dev/null
+++ b/twa/app/src/main/res/drawable-anydpi/shortcut_legacy_background.xml
@@ -0,0 +1,25 @@
+
+
+
+
+
+
+
+
+
diff --git a/twa/app/src/main/res/drawable-hdpi/splash.png b/twa/app/src/main/res/drawable-hdpi/splash.png
new file mode 100644
index 0000000..2be828d
Binary files /dev/null and b/twa/app/src/main/res/drawable-hdpi/splash.png differ
diff --git a/twa/app/src/main/res/drawable-mdpi/splash.png b/twa/app/src/main/res/drawable-mdpi/splash.png
new file mode 100644
index 0000000..322075a
Binary files /dev/null and b/twa/app/src/main/res/drawable-mdpi/splash.png differ
diff --git a/twa/app/src/main/res/drawable-xhdpi/splash.png b/twa/app/src/main/res/drawable-xhdpi/splash.png
new file mode 100644
index 0000000..452d523
Binary files /dev/null and b/twa/app/src/main/res/drawable-xhdpi/splash.png differ
diff --git a/twa/app/src/main/res/drawable-xxhdpi/splash.png b/twa/app/src/main/res/drawable-xxhdpi/splash.png
new file mode 100644
index 0000000..29891c2
Binary files /dev/null and b/twa/app/src/main/res/drawable-xxhdpi/splash.png differ
diff --git a/twa/app/src/main/res/drawable-xxxhdpi/splash.png b/twa/app/src/main/res/drawable-xxxhdpi/splash.png
new file mode 100644
index 0000000..4972524
Binary files /dev/null and b/twa/app/src/main/res/drawable-xxxhdpi/splash.png differ
diff --git a/twa/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/twa/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..0480797
--- /dev/null
+++ b/twa/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,33 @@
+
+
+
+
+