Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zlgopen/awtk-android
awtk-android port
https://github.com/zlgopen/awtk-android
android awtk
Last synced: 4 days ago
JSON representation
awtk-android port
- Host: GitHub
- URL: https://github.com/zlgopen/awtk-android
- Owner: zlgopen
- Created: 2019-07-29T01:36:12.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-03T04:05:38.000Z (17 days ago)
- Last Synced: 2024-11-03T05:17:06.096Z (17 days ago)
- Topics: android, awtk
- Language: Java
- Size: 29.4 MB
- Stars: 6
- Watchers: 5
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# awtk-android
awtk android 移植
> [预编译的demoui APK](http://zlgawtk.bceapp.com/awtk/demos/demoui.apk)
## 安装 android 开发环境
安装 android 开发环境比较麻烦，建议花几十块在淘宝上请人安装，绝对物有所值。
> 找人安装 Android 开发环境的时候，让他把 NDK 也安装上去。可以用命令行编译，也可以用 android studio 编译。android studio 可以用来调试 C 代码。
## 设置 android 环境变量
* Linux/MacOS Bash 下设置环境变量示例：
```
export ANDROID_HOME=/Users/jim/Library/Android/sdk/
export ANDROID_NDK_HOME=/Users/jim/Library/Android/sdk/ndk-bundle/
export PLATFORM_TOOLS_HOME=/Users/jim/Library/Android/sdk/platform-tools
export PATH=$PATH:$NDK_HOME:$PLATFORM_TOOLS_HOME
```
* Windows Bash 下设置环境变量示例：
```
export ANDROID_HOME=/c/Users/Admin/AppData/Local/Android/Sdk
export ANDROID_NDK_HOME=/c/Users/Admin/AppData/Local/Android/Sdk/ndk/21.3.6528147
export PLATFORM_TOOLS_HOME=/c/Users/Admin/AppData/Local/Android/Sdk/platform-tools
export PATH=$PATH:$ANDROID_NDK_HOME:$PLATFORM_TOOLS_HOME
```
* Windows Cmd 下设置环境变量示例：
```
set JAVA_HOME="C:/Program Files/Android/Android Studio/jre"
set ANDROID_HOME=C:/Users/Admin/AppData/Local/Android/Sdk
set ANDROID_NDK_HOME=C:/Users/Admin/AppData/Local/Android/Sdk/ndk/21.3.6528147
set Path=%Path%:%ANDROID_NDK_HOME%
```
* Windows PowerShell 下设置环境变量示例：
```
$env:JAVA_HOME="C:/Program Files/Android/Android Studio/jre"
$env:ANDROID_HOME="C:/Users/Admin/AppData/Local/Android/Sdk"
$env:ANDROID_NDK_HOME="C:/Users/Admin/AppData/Local/Android/Sdk/ndk/21.3.6528147"
$env:PATH="$env:PATH;C:/Users/Admin/AppData/Local/Android/Sdk/ndk/21.3.6528147"
```
> 具体路径请根据自己的情况进行调整，路径分隔符请用'/'，不要用 '\'。
## 下载 awtk 和 awtk-android 源码
```
git clone https://github.com/zlgopen/awtk.git
git clone https://github.com/zlgopen/awtk-android.git
git clone https://github.com/zlgopen/awtk-mobile-plugins.git
```
## 创建并编译 demoui 的工程
* 进入 awtk-android
```
cd awtk-android
```
* 创建工程
```
python create_project.py ../awtk/build.json
```
* 编译工程
```
cd build/demoui && ./gradlew build
```
> 生成的 apk 在：build/xxxxxx/app/build/outputs/apk/debug/app-debug.apk
>
> xxxxxx 是你的项目名。
## 创建并编译自己的工程
创建并编译自己的工程需要先写一个配置文件，请参考 [Android 平台编译配置](https://github.com/zlgopen/awtk/blob/master/docs/build_config.md)
后续过程和 demoui 完全一样。
> 不同平台有些差异，请酌情修改。建议使用 bash，Windows 下可以使用 git bash。
## 文档
* [用 android studio 调试应用程序](docs/how_to_debug_app_with_android_studio.md)
* [在 Windows 下编译 awtk android 版本](docs/build_on_windows.md)
* [在 windows 上面搭开发环境](docs/configure_development_environment_on_windows.md)
## 相关项目
* [awtk-mobile-plugins](https://github.com/zlgopen/awtk-mobile-plugins) 用于访问手机平台 (android/ios) 原生服务的插件（如分享、登录、相机、扫描二维码和蓝牙等）
## 其它问题
* 1. 修改 sdk 路径
如果 sdk 路径不对，可以直接修改 build/xxxxxx/local.properties 文件。
```
sdk.dir=/Users/jim/Library/Android/sdk/
ndk.dir=/Users/jim/Library/Android/sdk/ndk-bundle/
```
* 2. 修改 cmake 的版本号
如果 cmake 的版本与系统安装的不匹配，可以直接修改 build/xxxxxx/app/src/main/cpp/CMakeLists.txt 和 build/xxxxxx/app/build.gradle
* 3. 修改 gradle 的版本号
如果 gradle 的版本与系统安装的不匹配，可以直接修改 build/xxxxxx/build.gradle
* 4. 如果出现 Failed to install the following Android SDK packages as some licences have not been accepted
> 进入 SDK/tools/bin，执行。\sdkmanager.bat "platforms;android-28"
* 5. 使用国内镜像
> 请在网上搜索相关资料。
* 6. 设计时的分辨率
手机 APP 设计时可以采用 480x853，同时采用 layout 参数进行自适应布局。
* 7. 图标大小
手机 APP 需要提供不同屏幕密度的图标，请参考 [LCD 密度与图片的对应关系](https://github.com/zlgopen/awtk/blob/master/demos/assets/default/raw/images/README.md)
* 8. 设置 gradle 的版本和 socks 代理，请修改 ~/.gradle/gradle.properties
如：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-6.3-all.zip
org.gradle.jvmargs=-DsocksProxyHost\=127.0.0.1 -DsocksProxyPort\=1080
```
* 9. 只编译特定 arch 的版本
修改 app/build.gradle(23 行处），在 buildTypes 中增加 abiFilters 即可。
比如，只编译"arm64-v8a"，可以这样修改：
原来的：
```
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
```
修改后的：
```
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
ndk {
abiFilters "arm64-v8a"
}
}
debug {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
ndk {
abiFilters "arm64-v8a"
}
}
}
```
arch 的可选的值：
```
arm64-v8a
armeabi
armeabi-v7a
mips
x86
x86_64
```
> 编译多个arch时，用逗号分隔。
* 10. 输入法第一次弹出时，无法使用删除键。
> 第一次启动软键盘时，无法输入backspace/return等按键，没有找到原因，只好打个补丁：第一次启动时，通过InputConnection补发按键消息。
* 11. 使用AWTK内置的输入法
修改 app/src/main/cpp/CMakeLists.txt，放开下面两行代码。
```
# set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DWITH_DEFAULT_IM=1 -DWITH_IME_PINYIN=1 ")
# set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DWITH_DEFAULT_IM=1 -DWITH_IME_PINYIN=1 ")
```
> 对于旧的项目，可以加到if(${ANDROID_ABI} STREQUAL "armeabi-v7a")之前