README_zh_CN.md

Qt android 应用库

作者: 康林(kl222@126.com)

---

英语

• 源码目录
• 功能
• 编译
• 应用程序使用本库
• 捐赠
• 贡献 🍻

---

源码目录

|-- android/                          # The library source code
|      |-- QtAndroidUtilsModule
|             |-- jni                 # jni source code
|             |-- src                 # java source code
|-- daemon/                           # The daemon code

---

功能

• 验证存储权限
• 振动
• 屏幕唤醒
• Android 系统目录
• 消息通知
• 调用系统摄像头和相册
• 分享功能

---

编译

• 用 Qtcreate 打开 QtAndroidUtils.pro
• 编译
• 生成库
  • JNI库(*.so) : libQtAndroidUtilsModule.so
  • Android 库(.aar): QtAndroidUtilsModule-.aar

---

应用程序使用本库

• 做为源码使用：导入本工程到应用程序源码目录树中

  • 如果就用程序没有自己的 android 源码

    • 增加本工程到应用程序

      $ cd application_root
      $ git submodule add https://github.com/KangLin/QtAndroidUtils.git android
      

    • 增加 android/android.pri 到应用程序的主 pro 文件中

      $ cd application_root
      $ vim application.pro
      android: include(android/android/android.pri)
      

  • 如果应用程序有它自己的 android 源代码。例如: application_root/android

    $ ls application_root/android
    android.pri  AndroidManifest.xml  build.gradle  jni/  src/
    

    • 本工程做为子模块加入到应用程序的 android 目录:

        $ cd application_root/android
        $ git submodule add https://github.com/KangLin/QtAndroidUtils.git
      

    • 增加 jni 模块到应用程序的工程中

      • qmake 工程 ( android.pri )：

        $ cd application_root/android
        $ vim android.pri
        # 增加 jni
        android {
            # 包含 pri 文件
            include(QtAndroidUtils/android/QtAndroidUtilsModule/jni/jni.pri)
            # 包含头文件路径
            INCLUDEPATH *= QtAndroidUtils/android/QtAndroidUtilsModule/jni
        }
        

      • cmake 工程

        $ cd application_root
        $ vim CMakeLists.txt
        add_subdirectory(android/QtAndroidUtils/android/QtAndroidUtilsModule/jni)
        

    • 增加 JAVA 模块

      • 增加生成 JAVA 模块代码到 settings.gradle 中：

        $ cd application_root/android
        $ vim settings.gradle
        // 增加编译模块
        include ':QtAndroidUtils/android/QtAndroidUtilsModule'
        

      • 修改 build.gradle 增加 implementation project(':QtAndroidUtils/android/QtAndroidUtilsModule') 到 dependencies 块

        $ cd application_root/android
        $ vim build.gradle
        dependencies {
            // 增加依赖项目
            implementation project(':QtAndroidUtils/android/QtAndroidUtilsModule')
        }
        

• 做为库使用

  • Android 库(*.aar)

    • 复制 QtAndroidUtilsModule-release.aar 到 libs 目录中

    • 增加下列代码到 build.gradle 文件中：

      $ cd application_root/android
      $ vim build.gradle
      repositories {
          flatDir {
              dirs 'libs'
          }
      }
      

    • 增加下列代码到 dependencies 块：

      $ cd application_root/android
      $ vim build.gradle
      dependencies {
          implementation (name:'QtAndroidUtilsModule-release',ext:'aar')
      }
      

  • JNI 库(*.so)

    • qmake 工程

      • 导入库 libQtAndroidUtilsModule.so
      • 包含头文件

    • cmake 工程

      find_package(QtAndroidUtilsModule)
      

---

捐赠

贡献 🍻

• GitHub