使用 CMake 编译 Android 可执行程序的入门指南

本文将指导你如何使用 CMake 编译一个 Android 可执行程序。CMake 是一个强大的构建工具,广泛应用于跨平台软件开发。我们将按下述步骤进行:

步骤概览

步骤 描述
1 安装 Android NDK
2 创建项目目录结构
3 编写 CMakeLists.txt 文件
4 编写源代码
5 编译项目
6 运行生成的可执行程序

接下来,我们将详细说明每一个步骤以及相关的代码。

步骤详细说明

第一步:安装 Android NDK

首先,确保你已经安装了 Android NDK。可以从 Android 官方网站下载并按照提示进行安装。安装完成后,确保将 NDK 的路径添加到你的环境变量中。

第二步:创建项目目录结构

在你的工作目录下,创建一个新的文件夹用于存放项目文件:

mkdir MyAndroidApp
cd MyAndroidApp
mkdir app

以上命令创建了一个名为 MyAndroidApp 的文件夹,里面包含一个 app 子文件夹。

第三步:编写 CMakeLists.txt 文件

app 文件夹中创建一个名为 CMakeLists.txt 的文件,并加入以下内容:

cmake_minimum_required(VERSION 3.4.1) # 设置 CMake 最小版本

# 设置源文件
set(SOURCE_FILES main.cpp)

# 创建可执行目标
add_executable(MyExecutable ${SOURCE_FILES}) # 创建名为 MyExecutable 的可执行文件

该文件定义了 CMake 的最小版本,指定了源文件,并创建了一个名为 MyExecutable 的可执行目标。

第四步:编写源代码

app 文件夹中,创建一个名为 main.cpp 的文件并加入以下内容:

#include <iostream>

int main() {
    std::cout << "Hello, Android!" << std::endl; // 输出 "Hello, Android!"
    return 0; // 返回 0 表示程序成功结束
}

第五步:编译项目

在项目根目录下打开终端,然后执行以下命令:

mkdir build
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=$ANDROID_NDK/build/cmake/android.toolchain.cmake -DANDROID_PLATFORM=android-21  # 用 CMake 配置项目
make MyExecutable # 编译生成可执行程序

这段代码做了以下几件事情:

  • 创建了一个 build 文件夹,并进入其中。
  • 使用 cmake 配置项目,并指定 Android NDK 的工具链文件。
  • 使用 make 编译生成名为 MyExecutable 的可执行程序。

第六步:运行生成的可执行程序

编译完成后,你可以将可执行程序运行在 Android 模拟器或实际设备上。将生成的二进制文件从 build 文件夹中复制到你的设备上,然后通过终端运行它。

流程概述

sequenceDiagram
    participant User
    participant CMake
    participant BuildSystem

    User->>CMake: 创建 CMakeLists.txt
    Note right of CMake: 配置构建环境
    CMake->>BuildSystem: 生成构建文件
    User->>BuildSystem: 执行 make 命令
    BuildSystem->>User: 返回可执行文件

结尾

至此,我们已经完成了使用 CMake 编译一个简单 Android 可执行程序的全过程。通过这篇文章,你应该能够掌握基本的项目搭建、CMake 配置和编译过程。随着你对 CMake 和 Android 开发的深入理解,你将能够构建更复杂的应用程序。希望这篇指南能够帮助你更顺利地踏入 Android 开发的世界!请保持学习的热情,祝你编程愉快!