# QtAndroidDemo

**Repository Path**: tainheng812/QtAndroidDemo

## Basic Information

- **Project Name**: QtAndroidDemo
- **Description**: 本项目演示了如何将 Qt 界面嵌入到 Android 原生应用中，实现了原生 Android 与 Qt 框架的无缝集成。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt Android Demo 项目说明

本项目演示了如何将 Qt 界面嵌入到 Android 原生应用中，实现了原生 Android 与 Qt 框架的无缝集成。

## 📋 项目概述

**功能特点**：
- Qt 界面无缝嵌入 Android 原生应用
- 原生性能表现
- ARM64 架构支持 (arm64-v8a)
- Qt 与 Android 组件混合开发能力

**技术栈**：
- Qt 6.x for Android
- Android SDK/NDK
- CMake 构建系统

## 🚀 快速开始

### 前置要求

在运行此项目之前，请确保您已安装：

1. **Android Studio** (推荐最新稳定版)
2. **Qt for Android** (推荐 Qt 6.x 版本)
3. **NDK 和 CMake** (可通过 Android Studio SDK Manager 安装)
4. **JDK 8 或更高版本**

### 运行步骤

1. **打开 Android Studio**。
2. 选择 **Open**，然后导航到 `QtAndroidDemo\android_app` 目录。
3. 等待 Gradle Sync 完成。
4. 连接你的 Android 手机（确保开启了 USB 调试）或启动模拟器。
5. 点击顶部的绿色 **Run** 按钮 (三角形图标)。

## 📁 项目结构

```
QtAndroidDemo/
├── qt_lib/                    # Qt C++ 库源码
│   ├── CMakeLists.txt         # CMake 构建配置
│   └── *.cpp/*.h              # Qt 应用源代码
├── android_app/              # Android 宿主应用
│   ├── app/
│   │   ├── src/main/
│   │   │   ├── java/         # Java 源码
│   │   │   ├── jniLibs/      # 编译好的 .so 库
│   │   │   │   └── arm64-v8a/
│   │   │   ├── assets/       # Qt 资源文件
│   │   │   └── AndroidManifest.xml
│   │   ├── libs/             # Qt Android JAR 文件
│   │   └── build.gradle      # Gradle 构建配置
│   └── local.properties      # SDK/NDK 路径配置
├── QtLoader.bytecode         # Qt 加载器字节码
└── README.md                 # 项目说明
```

## 🔧 重新编译 Qt 库

如果你修改了 `qt_lib` 中的代码，你需要重新编译并复制库文件：

### Windows 环境配置

1. 需要安装 Qt 6.10 for Android 版本，确保已配置环境变量。我的安装目录在 `D:\Software\QT\`。
2. 打开终端，(点击任务栏的搜索框（或按 Win + S），输入 “PowerShell”) 进入 `qt_lib` 目录。
3. 运行以下命令 (确保环境变量已配置):

```powershell
# 1. 清理旧构建
if (Test-Path build) { Remove-Item -Recurse -Force build }

# 2. 设置必要的环境变量 (请根据实际路径修改)
$env:ANDROID_SDK_ROOT = "D:\Android\SDK"
$env:ANDROID_NDK_ROOT = "D:\Android\SDK\ndk\28.2.13676358"
# 确保 CMake 在 PATH 中
$env:PATH = "D:\Android\SDK\cmake\3.22.1\bin;" + $env:PATH

# 3. 运行 qt-cmake 进行配置
# 注意: -DQT_HOST_PATH 必须指向同版本的桌面 Qt 构建 (如 mingw_64 或 msvc)
& "D:\Software\QT\6.10.1\android_arm64_v8a\bin\qt-cmake.bat" -S . -B build -GNinja `
    -DANDROID_ABI=arm64-v8a `
    -DQT_HOST_PATH="D:\Software\QT\6.10.1\mingw_64"

# 4. 开始编译
cmake --build build

# 5. 部署 .so 库到 Android 项目
Copy-Item "build\libQtAndroidLib.so" "..\android_app\app\src\main\jniLibs\arm64-v8a\" -Force
```

## ⚠️ 注意事项

1. **架构兼容性**：当前项目仅支持 ARM64 架构 (arm64-v8a)，请确保目标设备支持此架构
2. **环境配置**：构建前请确认 Qt for Android 环境已正确配置
3. **路径适配**：根据你的本地环境调整 SDK、NDK 和 Qt 的路径


如需更多关于 Qt for Android 的信息，请参阅官方文档：
- https://doc.qt.io/qt-6/android.html
- https://doc.qt.io/qt-6/android-getting-started.html