ndk.symlinkdir - 在 Android Studio 3.5 及更高版本中,创建指向 NDK 的符号链接
在 Android Studio 3.5 及更高版本中,ndk.symlinkdir
是一个配置选项,用于在 Windows 系统上创建指向 NDK 安装目录的符号链接(symbolic link)。它的主要目的是解决 Windows 系统中 NDK 工具(如 ld.exe
)对长路径支持不佳的问题。
具体含义:
-
符号链接的作用
• NDK 的默认安装路径可能较长(例如C:\Users\YourName\AppData\Local\Android\Sdk\ndk\21.0.6113669
)。
• 通过ndk.symlinkdir
,可以生成一个更短的路径(例如C:\ndk\21.0.6113669
),避免因路径过长导致编译工具报错。 -
配置方法
在项目的local.properties
文件中添加以下配置:ndk.symlinkdir=C:\
这会生成符号链接
C:\ndk\<版本号>
,指向实际的 NDK 安装目录。 -
仅限 Windows
此功能主要针对 Windows 系统,因为 Unix/Linux/macOS 系统本身对长路径的支持较好,无需额外配置。
为什么需要?
• NDK 工具链中的某些工具(如链接器 ld.exe
)在处理长路径时可能失败。
• 缩短路径后,可以避免潜在的编译错误,尤其是在复杂项目或深层目录结构中。
注意事项:
• 修改 local.properties
时需谨慎,其他手动添加的属性可能导致问题。建议仅通过 Android Studio 或 Gradle 插件自动生成配置。
如果需要进一步操作,可以在 Android Studio 中同步项目(Sync Project)以使配置生效。