该版本内部完整版本号:2025.1.3.7(Narwhal3) ,Windows 分两种安装包(64 位系统):
一、官方归档下载页面(最安全)
中文官网历史存档页(国内访问友好)
developer.android.google.cn/studio/arch…
归档页面界面
版本筛选页面
- 打开页面 → 找到 Android Studio Narwhal 3 | 2025.1.3(Stable 稳定版)
- 展开下拉菜单,Windows 可选两个包:
- ✅ 安装版 EXE(推荐新手) :
android-studio-2025.1.3.7-windows.exe(带引导安装程序) - ✅ 绿色 ZIP 免安装版:
android-studio-2025.1.3.7-windows.zip(解压即用)
英文原归档页
developer.android.com/studio/arch…
二、安装前置硬件 & 系统要求
| 项目 | 最低配置 | 推荐配置(大疆 SDK 编译) |
|---|---|---|
| 系统 | Win10/Win11 64 位 | Win11 64 位 |
| 内存 | 8GB | ≥16GB(大疆 NDK 编译极吃内存) |
| 硬盘 | 空余 25GB | 固态硬盘 + 空余 40GB(AS+SDK+NDK + 缓存 + 大疆资源) |
⚠️ 硬性禁忌:所有安装路径不能含中文、空格、特殊符号(大疆 MSDK、NDK 中文路径必编译报错)
额外提前准备(大疆必用)
- 提前下载:大疆 Mobile SDK 官方 Sample 工程(去大疆开发者中心developer.dji.com/ 资源中心下载)
- 后续需:提前注册大疆开发者账号,创建应用获取
APP_KEY(运行 MSDK 必须参数)
三、Android Studio 分步安装(EXE 安装版)
-
右键 exe→以管理员身份运行安装程序
-
Install Wizard 页面:
- 勾选组件:✅Android SDK ✅Android Virtual Device(模拟器,可选,真机调试可不勾)
- 安装路径修改:自定义路径如
D:\Android\AndroidStudio2025.1.3,禁止 C 盘 + 中文
-
Android SDK 安装路径:
D:\Android\AndroidSDK(单独目录,后续配置环境变量) -
等待安装进度完成,勾选
Launch Android Studio,点击 Finish 启动
ZIP 免安装版操作:解压到纯英文路径,进入 bin 目录双击
studio64.exe启动
四、首次启动初始化配置(大疆 SDK 关键配置项)
步骤 1:导入配置弹窗
选择:Do not import settings(不导入旧版本配置) ,避免旧 Gradle/SDK 冲突
步骤 2:代理与 JDK 配置
- Proxy:国内选
No proxy,后续配阿里云镜像,无需科学上网 - JDK:本版本 AS 自带内置 JDK17(路径:
AS安装目录\jbr),不要自行安装 JDK8,2025.1 强制 JDK17,大疆 MSDK 兼容 JDK17
步骤 3:SDK 组件下载(重中之重,适配大疆 MSDK)
打开 File→Settings→Appearance&Behavior→System Settings→Android SDK
① SDK Platforms(平台版本)
勾选 3 个版本(大疆 MSDK 主流适配):
- Android 11 (API30)(minSdk 兜底)
- Android 13 (API33)(大疆官方推荐 targetSdk)
- Android 14 (API34)(新版遥控器 / 手机适配)
② SDK Tools(工具,大疆 NDK 必装)
展开勾选:
- Android SDK Build-Tools:勾选
34.0.0(大疆常用编译工具) - NDK (Side by side):勾选
27.2.12479018(大疆 Mobile SDK 固定适配 NDK27,版本错直接编译失败) - CMake:勾选
3.31.0+(NDK 跨平台编译依赖,MSDK 底层 C++ 编译需要) - Android SDK Command-line Tools、Android Emulator、Android Platform Tools 全部勾选
点击 Apply→OK,自动下载全部组件,等待下载完成
五、Windows 系统环境变量配置(adb 调试 + NDK 全局调用)
- 此电脑→右键属性→高级系统设置→环境变量→系统变量→新建
plaintext
变量名:ANDROID_HOME
变量值:D:\Android\AndroidSDK(你的SDK实际路径)
2. 在系统变量Path中新增两条:
plaintext
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\build-tools\34.0.0
3. 验证:新开 CMD 输入adb version,输出版本号即配置成功(后续大疆遥控器 / 手机 adb 调试必备)
六、AS调试&&Mobile-SDK-Android-V5接入
解压的源码目录层级错乱时:直接打开 SampleCodeV5/android-sdk-v5-as 作为 AS 项目根目录(不要打开最外层压缩包根文件夹),File→Open 选中android-sdk-v5-as,重新打开项目。
一定要在AS的项目根目录打开,因为其他的SDK也有gradle,不然会无法加载gradle
报错原因:终端路径错误
gradlew.bat 文件在 android-sdk-v5-as 文件夹内,你现在处在上级SampleCode-V5目录,找不到脚本。
1、先切换目录,在终端输入:
powershell
cd ./android-sdk-v5-as
回车后,再执行带路径的命令:
powershell
.\gradlew.bat projects
2、运行成功后效果
命令执行完毕,AS 自动绑定 Gradle 项目,View→Tool Windows→Gradle由灰色变为可点击。
3、备选方案(最简根治)
File → Close Project关闭工程回到 AS 欢迎页- 点
Open,只选中android-sdk-v5-as文件夹打开项目(唯一正确根目录)打开后 AS 自动识别 Gradle,Gradle 菜单直接解锁,无需输命令。
4、settings.gradle 排版顺序
📌 文件路径:左侧项目树 → android-sdk-v5-as 文件夹内 → settings.gradle
groovy
//【第一块:最顶部先放pluginManagement】
pluginManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url "https://maven.dji.com/artifactory/mobile-sdk/" }
google()
mavenCentral()
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url "https://maven.dji.com/artifactory/mobile-sdk/" }
google()
mavenCentral()
}
}
//【再写模块引入】
include ':sample',':uxsdk'
project(':sample').projectDir = new File(rootProject.projectDir, '../android-sdk-v5-sample')
project(':uxsdk').projectDir = new File(rootProject.projectDir, '../android-sdk-v5-uxsdk')
保存文件。
5、终端再次执行命令
powershell
.\gradlew.bat projects
出现两个模块sample、uxsdk列表 = 编译成功。
七、AndroidManifest 关键配置(你当前打开的文件)
- 大疆鉴权 KEY 替换底部:
xml
<meta-data
android:name="com.dji.sdk.API_KEY"
android:value="${API_KEY}"/>
把${API_KEY}删掉,引号内填入你在大疆开发者后台申请的 APP_KEY 字符串。
- 应用包名核对清单顶部:
package="dji.sampleV5.aircraft"去android-sdk-v5-sample/build.gradle,确认applicationId = "dji.sampleV5.aircraft"
⚠️ 大疆开发者后台创建应用时,注册包名必须和上面一字不差,否则 SDK 鉴权直接失败。
- Google 地图 KEY(暂时不用)
<meta-data android:name="com.google.android.geo.API_KEY" android:value="${GMAP_API_KEY}"/>如果不用谷歌地图,可直接注释删掉这一行。
6、成功后打开 AS
关闭终端,Android Studio 打开android-sdk-v5-as,自动识别android-sdk-v5-sample(出现绿色安卓图标),即可新建运行配置、插真机跑大疆 Demo。