Android Studio 版本下载指南 & 接入dji-sdk / Mobile-SDK-Android-V5

0 阅读5分钟

该版本内部完整版本号:2025.1.3.7(Narwhal3) ,Windows 分两种安装包(64 位系统):

一、官方归档下载页面(最安全)

中文官网历史存档页(国内访问友好)

developer.android.google.cn/studio/arch…

转存失败,建议直接上传图片文件image

归档页面界面

转存失败,建议直接上传图片文件image

版本筛选页面

  1. 打开页面 → 找到 Android Studio Narwhal 3 | 2025.1.3(Stable 稳定版)
  2. 展开下拉菜单,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 中文路径必编译报错)

额外提前准备(大疆必用)

  1. 提前下载:大疆 Mobile SDK 官方 Sample 工程(去大疆开发者中心developer.dji.com/ 资源中心下载)
  2. 后续需:提前注册大疆开发者账号,创建应用获取APP_KEY(运行 MSDK 必须参数)

三、Android Studio 分步安装(EXE 安装版)

  1. 右键 exe→以管理员身份运行安装程序

  2. Install Wizard 页面:

    • 勾选组件:✅Android SDK ✅Android Virtual Device(模拟器,可选,真机调试可不勾)
    • 安装路径修改:自定义路径如 D:\Android\AndroidStudio2025.1.3,禁止 C 盘 + 中文
  3. Android SDK 安装路径:D:\Android\AndroidSDK(单独目录,后续配置环境变量)

  4. 等待安装进度完成,勾选Launch Android Studio,点击 Finish 启动

ZIP 免安装版操作:解压到纯英文路径,进入 bin 目录双击studio64.exe启动

四、首次启动初始化配置(大疆 SDK 关键配置项)

步骤 1:导入配置弹窗

选择:Do not import settings(不导入旧版本配置) ,避免旧 Gradle/SDK 冲突

步骤 2:代理与 JDK 配置

  1. Proxy:国内选No proxy,后续配阿里云镜像,无需科学上网
  2. 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 必装)

展开勾选:

  1. Android SDK Build-Tools:勾选34.0.0(大疆常用编译工具)
  2. NDK (Side by side):勾选27.2.12479018(大疆 Mobile SDK 固定适配 NDK27,版本错直接编译失败)
  3. CMake:勾选3.31.0+(NDK 跨平台编译依赖,MSDK 底层 C++ 编译需要)
  4. Android SDK Command-line Tools、Android Emulator、Android Platform Tools 全部勾选

点击 Apply→OK,自动下载全部组件,等待下载完成

五、Windows 系统环境变量配置(adb 调试 + NDK 全局调用)

  1. 此电脑→右键属性→高级系统设置→环境变量→系统变量→新建

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 调试必备)

image.png

六、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、备选方案(最简根治)

  1. File → Close Project 关闭工程回到 AS 欢迎页
  2. 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

出现两个模块sampleuxsdk列表 = 编译成功。

七、AndroidManifest 关键配置(你当前打开的文件)

  1. 大疆鉴权 KEY 替换底部:

xml

<meta-data
    android:name="com.dji.sdk.API_KEY"
    android:value="${API_KEY}"/>

${API_KEY}删掉,引号内填入你在大疆开发者后台申请的 APP_KEY 字符串

  1. 应用包名核对清单顶部:package="dji.sampleV5.aircraft"android-sdk-v5-sample/build.gradle,确认applicationId = "dji.sampleV5.aircraft"

⚠️ 大疆开发者后台创建应用时,注册包名必须和上面一字不差,否则 SDK 鉴权直接失败。

  1. Google 地图 KEY(暂时不用)<meta-data android:name="com.google.android.geo.API_KEY" android:value="${GMAP_API_KEY}"/>如果不用谷歌地图,可直接注释删掉这一行。

image.png

image.png

6、成功后打开 AS

关闭终端,Android Studio 打开android-sdk-v5-as,自动识别android-sdk-v5-sample(出现绿色安卓图标),即可新建运行配置、插真机跑大疆 Demo。