Delphi 安卓开发环境搭建全攻略：SDK/NDK/JDK 配置与踩坑实录

简介面向 Delphi 121 环境下的安卓 SDK 配置需求这份教程针对安卓开发初学者和刚从 IDE 集成开发环境转向移动端开发的工程师重点解决 PlatformSDKs 解压、IDE 内 SDK Manager 替换、以及 Android SDK/NDK/JDK 路径对接等常见问题。包体为单个 PDF共 1 个文档压缩包大小 1.3MB内容浓缩但步骤完整适合按文档提示逐项操作。目前已有 158 人学习下载处于稳定参考状态。除常规操作流程外文档还点明 android-33 版本选择这一关键环节并给出具体路径示例便于读者在 Embarcadero Studio 23.0 中快速完成配置对不熟悉 SDK 路径映射或 NDK、JDK 版本匹配的开发者能有效减少试错直接对照完成环境搭建。 入坑 Delphi 安卓开发有一段时间的人估计都经历过这么一幕代码写得好好的点一下 RunAndroid SDK 路径飘红PlatformSDKs 配置弹个红叉构建链直接断掉。说白了Delphi 本身编译安卓逻辑不算难真正的拦路虎反而在环境——SDK、JDK、NDK 这三件套版本对不上后面全是坑。这篇就把平台搭建的完整步骤、IDE 里怎么把 SDK 挂上去、以及我实测中踩过的所有典型问题一次说清楚。这篇内容适合刚拿到 Delphi 12/13对应标题里提到的 121 系列新版本准备上手安卓开发的人也适合被环境问题折磨得想砸电脑的老油条。里面所有路径、参数、命令都是我本机验证过的照着抄基本能跑通剩下个性化的地方我会特别标注。1. 项目背景与整体配置思路1.1 为什么 Delphi 开发安卓离不开 SDK 环境Delphi 走的是编译到原生 ARM 指令的路线和 Java/Kotlin 那套跑在虚拟机上不一样。但安卓系统本身是 Linux 内核加 ART 运行时应用要装进去、要访问系统 API、要签名打包就必须依赖 Google 提供的那一整套安卓 SDK 工具链。简单点说Delphi 负责把你的 Pascal 代码变成机器码SDK 负责把这个机器码正确封装成安卓认识的 APK 文件。很多人一开始觉得“我装个 Delphi 不就能开发了吗”这是最大的误会。没有 PlatformSDKsDelphi 连最基础的 Activity 生命周期都对接不上更别提资源打包、权限声明这些事了。打个比方Delphi 是厨师SDK 是厨房菜谱写得再好没锅没灶你也只能干瞪眼。1.2 核心组件选型JDK、SDK、NDK 怎么搭配配置前最头疼的就是版本搭配。根据我这几年折腾的经验把版本对应关系整理成一张表照着选能省掉一大堆兼容性报错。组件推荐版本说明Delphi12.x / 13.x新版对 Android API 33 支持更好JDK11 或 1764位Delphi 12 及以上建议 JDK 17Android SDKAPI 33 或 34编译目标别盲目追最新NDKr25c 或 r26和 SDK 版本配套下载Build-Tools34.0.0SDK Manager 里自动带这里有个重要的点老版本 Delphi比如 10.x只能用 32 位 JDK 来跑 Java 编译器但新版本已经支持 64 位了。你要是还在用旧版记得去 Oracle 官网下载 x86 版本的 JDK否则会报“Unable to execute javac”之类的错。1.3 我的环境准备清单拿我自己的机器举例Windows 11 专业版Delphi 13 完整安装包先把以下三样提前下好JDK 17Windows x64 安装版Android Studio 自带的最新 SDK或者单独下 command-line-tools一部开启了开发者模式的安卓真机用于最终部署测试顺便提醒一句如果你的电脑之前装过 Android StudioSDK 位置默认在C:\Users\你的用户名\AppData\Local\Android\Sdk后面配置时可以直接指过去不需要重复下载。2. PlatformSDKs 环境搭建从零开始装齐三件套2.1 JDK 安装与环境变量配置JDK 安装本身没什么难度双击下一步就行但环境变量这一步很多人会漏。装完以后打开系统属性 - 环境变量在系统变量里新建JAVA_HOME C:\Program Files\Java\jdk-17然后在Path里追加%JAVA_HOME%\bin完成后打开命令行输入java -version确认能正常输出版本号。Delphi 在配置 SDK 时其实是通过注册表或 IDE 内置检测来找 JDK 的环境变量更多是给命令行工具用的但建议还是配好后面排障、跑 gradle 脚本都用得上。我见过最典型的问题是把 JDK 装到了带空格的路径下比如C:\Program Files\Java\jdk-17Delphi 某些版本解析路径时会把空格打断导致找不到。如果你遇到诡异的 JAVA_HOME 失效问题最简单粗暴的办法是把 JDK 解压版放到C:\Dev\jdk-17这种无空格路径下直接指定这个目录。2.2 Android SDK 下载与版本选择Android SDK 的获取方式有两种我更推荐第一种直接安装 Android Studio用它的 SDK Manager 下载组件只下载 command-line-tools纯命令行方式安装如果你不想为配置环境装一个整整 1GB 的 Android Studio那就去 Google 官方页面下载 command-line-tools 压缩包。解压到一个目录比如C:\Android\cmdline-tools然后打开命令行执行cd C:\Android\cmdline-tools\bin sdkmanager platform-tools platforms;android-34 build-tools;34.0.0这里有一个很容易踩的坑新版 cmdline-tools 对目录结构有要求必须放在cmdline-tools\latest\bin这种层级下否则会报“Warning: Could not find SDK folder”之类的错。强制把解压出来的文件挪到C:\Android\cmdline-tools\latest\下再执行命令就正常了。2.3 NDK 安装的必要性与具体配置Delphi 官方其实对 NDK 的依赖不像纯原生安卓开发那么重因为 RAD Studio 自带的编译器已经可以处理原生 C/C 代码的交叉编译。但在某些场景下——比如你引入了第三方 C 静态库或者要用到 Delphi 的 C Builder 混合编译——NDK 就是刚需。在 SDK Manager 里用命令行安装 NDKsdkmanager ndk;25.2.9519653装完之后在 Delphi 里指定 NDK 路径时要选到有source.properties文件的那一层目录。很多人的报错“NDK path is incorrect”就是因为路径指到了外层而不是包含实际工具链的内层。2.4 PlatformSDKs 与 Delphi 工具链的路径约定Delphi 的 Tools - Options - Deployment - SDK Manager 是所有配置的核心入口。打开后你会看到一个已经预置好的 Android SDK 条目默认路径可能指向一个不存在的目录需要手动改为你实际的 SDK 位置。按照上面装好的目录结构我本机的配置如下配置项路径Android SDKC:\Android\SdkJDKC:\Dev\jdk-17NDKC:\Android\Sdk\ndk\25.2.9519653填完之后点 Update Local File Cache等进度条走完确认状态栏里没有红色报错就说明 SDK 识别成功了。这一步是整个环境配置中最核心的一步路径只要错一点点后面编译出的问题都排查得特别痛苦。3. IDE 集成设置让 Delphi 真正“认识”安卓 SDK3.1 Delphi IDE 内 SDK Manager 详细设置打开 Delphi菜单栏依次进入 Tools - Options - Deployment - SDK Manager。界面上会列出当前已注册的 SDK 平台左侧可以看到 Android 32-bit、Android 64-bit 等条目。把默认条目选中右侧的 Java SDK 路径和 SDK 路径都改成刚才安装的目录。有一个操作是新手最容易忽略的改完路径后不要直接点 OK而是先点右上角的 “Update Local File Cache” 按钮。这个动作会让 Delphi 重新扫描 SDK 目录下的 API 级别和 build-tools 版本并把平台库文件同步到本机缓存里。不执行这一步后面新建工程时目标平台列表会一直是空的。扫描完成后在左侧展开 Android 条目你应该能看到类似API 34 Android 14这样的子项。右键选择设置为默认或者确保它处于激活状态。我在这一步还额外做了一件事把 Delphi 自带的默认 SDK 平台删掉重新添加自己下载的 API 34避免旧缓存干扰新 SDK。3.2 模拟器 AVD 创建与真机调试连接准备环境配置好之后运行方式有两种模拟器和真机。如果你要用模拟器最方便的是在 Android Studio 里通过 Device Manager 创建 AVD。新建 AVD 时系统镜像建议选 x86_64 版本因为 Delphi 编译出的调试版 APK 大部分是 x86 指令集跑在模拟器上兼容性最好。如果顺手选了 ARM 镜像在 Intel/AMD 机器上会慢得像幻灯片。真机调试则要把手机的开发者选项打开开启 USB 调试然后插线。第一次连接时手机屏幕会弹出“允许 USB 调试吗”的框勾选一律允许。电脑端打开命令行输入adb devices能看到设备编号加device字样就说明驱动正常。我遇到过一种情况手机插上后adb devices有反应但 Delphi 的 Deploy 界面就是找不到设备。后来发现是 Android 11 以上版本默认的 USB 配置是“仅充电”需要把通知栏里的 USB 模式手动改成“文件传输/MTP”改了之后立刻就能识别。3.3 工程级配置Android 清单与签名设置新建一个 Delphi 多设备应用工程后Project Manager 里右键目标平台选择 Android 64-bit。这时会生成一组安卓专属选项在 Project - Options 里能找到。第一处需要改的是 Version Info 里的 Package Name默认是一长串com.embarcadero.XXX建议改成自己项目的逆向域名比如com.mydemo.app。包名会在安装时作为应用的唯一标识如果和别的应用冲突安装时会直接报 INSTALL_FAILED_UPDATE_INCOMPATIBLE。第二处是签名配置。Development 模式下 Delphi 会自动生成一个 debug keystore 用于调试安装真机部署时不需要额外配置。但如果你要生成 release 版本发给别人需要去 Provisioning 里创建或导入正式证书。我自己的习惯是提前用keytool生成一个独立的签名文件keytool -genkey -v -keystore myrelease.keystore -alias myalias -keyalg RSA -keysize 2048 -validity 10000生成后把路径填写到 Project Options - Provisioning 的 Release 签名配置里。这里提醒一下签名文件一定要保存好安卓应用的升级包必须用同一把签名一旦丢失以后就再也无法覆盖安装新版本了。4. 实操流程从空工程到真机运行的全过程4.1 新建工程与目标平台切换打开 DelphiFile - New - Multi-Device Application选 Blank Application 模板。默认的 Target Platforms 里通常只有 Windows 64-bit需要在 Project Manager 窗口里右键 Target Platforms 节点选择 Add Platform勾选 Android 64-bit。第一次切换到 Android 平台Delphi 会自动检查 SDK 配置并生成编译所需的配置文件。如果你前面 SDK Manager 配置正确几秒钟后平台节点会变成可展开状态里面会自动出现 ConfigurationDebug和 ConfigurationRelease两个条目。如果这里报错九成是 SDK 路径问题回上一章检查。还有一成的可能是 Delphi 第一次构建 Android 需要下载预编译的 runtime 包网络慢的话会卡在某个百分比很久等就行不要以为死机了。4.2 编译并部署到真机的详细步骤我在窗体上拖了一个 TButton 和一个 TLabel点击事件里让 Label 显示一句“Hello Android”然后直接按 F9 运行。Delphi 的处理过程是这样的编译 Pascal 代码生成 .so 文件调用 SDK 的 aapt2 工具打包资源用 zipalign 对齐 APK 文件用 apksigner 签名Debug 模式自动用 debug keystore通过 adb 安装到连接的设备并启动整个过程在第一次执行时会比较慢尤其是生成 .so 文件那一步我的机器大概耗时 30 秒到 1 分钟。之后增量编译就很快了。部署成功后手机上会自动弹出应用并显示 “Hello Android”。这种从写代码到跑在手机上的完整链路整体体验其实比 Android Studio 还顺手代码改动后按一下 F9 就能看效果。4.3 多平台同时构建的小技巧Delphi 做多端开发最大的爽点是同一个工程可以同时选 Windows 和 Android 平台。我在实际项目里常用一个操作把 Windows 平台也勾上平时调试 UI 布局直接跑 Windows 版本速度快得多等 iOS/Android 端的功能逻辑写完了再切平台编译。对了还有一个小技巧Project Manager 里可以同时勾选多个平台点 BuildDelphi 会依次编译生成各平台的产物。要是你有 C Builder 的第三方库依赖记得在 Project Options 的 C Linker 选项里把库路径配好否则交叉编译到安卓时会报 undefined reference 的错误。5. 常见问题与排查技巧实录5.1 SDK 路径相关的高频报错配置过程中最常遇到的就是路径识别失败。我整理了一张自己碰到过的报错和处置对照表报错信息原因解法SDK directory not foundSDK 路径指向了 cmdline-tools 而非根目录指到包含 platforms、build-tools 的根目录NDK path is incorrect路径没有指到含 source.properties 的层补全到ndk\版本号Java compiler not foundJDK 路径错误或版本不匹配确认 Delphi 版本对应的 JDK 位数与版本Unable to execute aapt2build-tools 版本过旧或缺失用 sdkmanager 安装 build-tools;34.0.0zipalign not foundplatform-tools 未安装执行 sdkmanager platform-tools路径类问题的共性规律是 Delphi 对目录结构非常挑剔它不像 Android Studio 那样会自动适配。凡是路径报错先确认是不是指到了子目录的再下一层80% 的问题出在这。5.2 设备识别失败与部署中断的解决真机部署时adb devices能看到设备但 Delphi Deploy 界面是空的。先按顺序排查USB 线很多劣质线只能充电不能传输、驱动Windows 下装一下手机厂商的 USB 驱动、USB 模式改成 MTP 或文件传输、开发者选项里的 USB 调试是否关闭再重开。部署到一半报“Installation failed - no devices found”大概率是 adb 服务挂了。别慌在命令行执行adb kill-server adb start-server adb devices重启 adb 服务后回到 Delphi 重新点 Run 就好。还有一个场景同一台电脑连多部设备时Delphi 默认选择哪个设备不固定建议在 Project Options - Deployment 里指定设备序列号或者只连一部设备。5.3 编译内存溢出与构建速度优化大型项目编译安卓包时偶尔会报 Java heap space 错误。这是因为 Delphi 调用 SDK 工具链时给 JVM 分配的内存不够。解决办法是手动设置环境变量set JAVA_TOOL_OPTIONS-Xmx2048m或者在C:\Android\cmdline-tools\latest\bin\sdkmanager.bat文件里修改默认的 JVM 参数。构建速度方面我有几个心得不要每次 Build 前都清空缓存Debug 模式下用 Deploy 而不是 Clean把杀毒软件的实时监控排除 Delphi 安装目录和 SDK 目录否则每次生成 .so 文件都会被扫描拖慢好几秒第一次全量编译会慢一些之后只要不大改 androidmanifest.xml增量编译基本能在十秒内完成。5.4 SDK Manager 版本杂乱造成的隐形崩溃很多人在折腾过程中会装好几个不同版本的 SDK、NDK、Build-Tools导致 Delphi 扫描时加载了冲突的组件。一个非常典型的症状就是编译一路绿灯但 APK 装上去秒退Logcat 里什么关键信息都没有。解决办法是彻底清理一遍。在 SDK Manager 里把不再需要的 API Level 全部卸载Build-Tools 只保留一个当前项目用的版本。Delphi 的资料目录C:\Users\用户名\AppData\Roaming\Embarcadero\BDS\版本号里的 SDK 缓存文件也可以删掉让 IDE 重新扫描。这个操作我至少救回三次因为版本混乱导致的项目环境崩溃。6. 我总结的一点项目经验整个配置流程走下来你会发现Delphi 安卓开发的瓶颈从来不在语言本身而在于工具链的版本对应关系。JDK 17 选对、SDK API 34、NDK 25、Build-Tools 34这四个数字只要统一后面的开发体验确实非常丝滑。最后分享一个我的个人习惯每次重装系统或换新电脑我会把 SDK 目录整个打包备份到移动硬盘路径约定不变的情况下新机器解压、配置环境变量、指一下 Delphi 的 SDK 路径十分钟就能恢复整个安卓开发环境。比现场下载 SDK、等 Google 服务器传输快太多了。这套环境配置步骤看着繁琐但只要你按顺序把这些组件一次装对、版本锁死之后 Delphi 写安卓的体验绝对超出你的预期。本文还有配套的精品资源点击获取