简介本资源是面向Android应用开发者的SDK平台组件包专为适配Android 5.1.1API级别22系统环境而设计适用于需要兼容Lollipop版本设备的中高级开发者及教学实训场景。压缩包共含2000个文件涵盖6003张PNG系统图标、1324份XML布局与配置资源、130页HTML格式API文档、91种字体文件ttf及4个核心JAR库如platform.jar完整支撑编译、调试、UI适配与源码查阅需求整体体积63.56MB结构清晰包含system-images、docs、sources、res等标准SDK平台目录。目前已有211人学习下载资源内含framework.aidl接口定义、color_fade_frag.frag着色器片段、accessibility_gestures.bin手势数据等典型Lollipop特性文件便于深入理解Material Design实现机制与系统级交互逻辑。1. 从“android-22.zip”说起一个被遗忘的SDK包意味着什么如果你在某个老旧的硬盘角落或者一个尘封的项目备份里翻到了一个名为“android-22.zip”的文件你的第一反应是什么是直接删除还是带着一丝好奇去探究它背后的故事对于很多刚接触Android开发不久的朋友或者那些一直在使用Android Studio的自动更新功能、从未手动处理过SDK的开发者来说这个文件可能显得陌生又古老。但恰恰是这些以版本号命名的压缩包构成了Android应用开发的基石。今天我们就来彻底拆解这个“android-22.zip”它不仅仅是Android 5.1Lollipop MR1系统镜像和平台工具的一个离线包更是一把钥匙能帮你理解Android SDK管理的底层逻辑解决那些让新手头疼的“网络失败”、“目录创建失败”等问题。简单来说Android SDK (SDK Platforms)-android-22.zip是Android SDK中“平台工具包”的一个特定版本API Level 22的离线安装包。在理想的网络环境下我们通过Android Studio的SDK Manager点点鼠标就能下载一切。但现实往往是骨感的公司内网限制、糟糕的网络代理配置、或者单纯地想为团队搭建一个统一的离线开发环境这时手动管理这些ZIP包就成了必备技能。理解它你就能摆脱对IDE网络下载的绝对依赖甚至在CI/CD流水线中实现SDK环境的快速部署。接下来我会带你从文件结构、使用场景到手动集成避坑完整走一遍。2. 解剖“android-22.zip”里面到底装了些什么当你解压这个ZIP文件后得到的并不是一个可以直接运行的应用程序而是一个遵循特定目录结构的“资源包”。这个结构是Android SDK Tools如sdkmanager能够识别并正确安装的关键。我们以android-22为例看看它的典型内容android-22/ ├── android.jar ├── framework.aidl ├── data/ │ ├── layoutlib.jar │ └── ... ├── skins/ │ └── ... ├── build.prop ├── source.properties └── ... (其他系统镜像文件如果包含的话)核心文件解读android.jar这是最核心的文件。它包含了针对API Level 22Android 5.1编译时所需的全部类库和API定义。当你在build.gradle中设置targetSdkVersion或compileSdkVersion为22时Gradle编译器就会使用这个JAR文件来检查你的代码语法、方法调用是否合法。它定义了你能“看到”和“调用”的所有系统API。framework.aidlAndroid接口定义语言文件。系统服务如电话、短信的接口描述就定义在这里用于跨进程通信IPC的代码生成。data/layoutlib.jar布局渲染库。Android Studio的布局预览Preview面板依赖这个库来在IDE中渲染出对应API级别的UI样式。如果没有它预览面板可能会报错或显示不正确。skins/包含Android模拟器的皮肤文件用于定义不同设备如Nexus 5、Pixel的模拟器外观。build.prop类似于Android设备的/system/build.prop文件定义了该平台版本的各种系统属性在构建和模拟器运行时会被读取。source.properties这个文件是SDK包的“身份证”。它里面记录了该包的Pkg.Revision修订版本号、Pkg.Path安装相对路径如platforms;android-22等元信息。SDK Manager完全依靠这个文件来识别和管理已安装的包。重要区分android-22.zipvssdk-tools-*.zip这是最容易混淆的地方。android-22.zip是平台Platform它提供编译和运行时的API框架。而sdk-tools-*.zip或platform-tools-*.zip是工具Tools里面包含的是adb、fastboot、sdkmanager这些命令行工具。它们是两个不同的组件通常需要分开下载和管理。当你遇到“安装android sdk显示failed to create directory”这类错误时问题往往出在工具链的安装或环境配置上而非平台包本身。3. 为什么需要手动处理离线SDK包四大典型场景在云端和高速网络普及的今天手动下载一个几百兆的ZIP包似乎有些“复古”。但以下场景中这项技能能救你于水火场景一封闭或受限的网络环境很多企业的开发网络出于安全考虑无法直接访问Google的官方仓库dl.google.com。Android Studio的SDK Manager会直接报错。这时运维人员通常会事先从外网下载好所需的SDK平台包和工具包放置在内网文件服务器或共享目录中。开发者就需要手动将这些ZIP包放置到正确的位置或者配置SDK Manager使用本地镜像源。场景二搭建统一、可复现的团队开发环境为了确保团队所有成员、以及构建服务器如Jenkins使用完全一致的SDK版本避免因SDK组件版本差异导致的“在我机器上是好的”这类问题。将核准版本的SDK平台包归档作为项目基础设施的一部分是实现环境标准化的有效手段。场景三历史项目的维护与构建你可能需要维护一个非常古老的应用其targetSdkVersion被锁定在了22。而最新版的Android Studio SDK Manager可能已经不再默认提供这个版本的下载或者在图形界面中隐藏得很深。拥有一个离线包就能随时恢复出准确的构建环境。场景四解决诡异的“Failed to create directory”错误这个错误在网络搜索中热度很高。它通常发生在权限不足你试图将SDK安装到系统保护目录如C:\Program Files下但没有以管理员权限运行Android Studio或命令行。路径包含特殊字符或空格SDK路径中含有中文字符、括号或空格某些旧版本工具处理不当。磁盘空间不足或路径不存在目标磁盘已满或者你指定了一个不存在的父目录。防病毒软件或安全软件拦截实时防护软件可能会阻止程序创建目录或写入文件。当自动安装失败时手动解压ZIP包到正确路径往往是绕过这些环境问题最直接粗暴且有效的方法。4. 手动安装“android-22.zip”的完整操作指南假设我们已经下载好了android-22.zip文件现在要将其手动集成到现有的Android SDK目录中。以下是详细步骤和原理说明。步骤1定位你的Android SDK根目录首先你需要知道SDK装在哪。打开Android Studio点击File - Settings - Appearance Behavior - System Settings - Android SDK。在Android SDK Location一栏显示的路径就是你的SDK根目录例如C:\Users\YourName\AppData\Local\Android\Sdk或/Users/YourName/Library/Android/sdk。步骤2确定正确的目标路径SDK目录有严格的子目录结构。平台包必须放在[SDK根目录]/platforms/下面。 因此android-22.zip解压后的内容应该整个放在[SDK根目录]/platforms/android-22/中。步骤3执行解压与放置在文件管理器中进入你的SDK根目录下的platforms文件夹。如果不存在就手动创建一个。将android-22.zip复制或移动到platforms文件夹旁边不是里面为了方便操作。右键点击ZIP文件选择“解压到当前文件夹”或使用命令行unzip android-22.zip。你会得到一个名为android-22的文件夹。现在将这个android-22文件夹移动到platforms文件夹内部。 最终结构应该是[SDK根目录]/platforms/android-22/android.jar, build.prop, ...步骤4验证安装手动放置后最好让SDK管理工具“知道”它的存在。方法A使用命令行工具推荐打开终端CMD, PowerShell, Bash进入SDK根目录下的cmdline-tools/latest/bin目录如果你安装了Command-line Tools。 执行命令./sdkmanager --list --verbose在输出的已安装包列表中仔细查找platforms;android-22。如果看到它并且状态显示为Installed说明识别成功。--verbose参数会显示安装路径你可以核对是否是你的手动路径。方法B查看Android Studio重启Android Studio再次进入Settings - Android SDK - SDK Platforms选项卡。你应该能在列表中找到 “Android 5.1 (API 22)”并且其前面的复选框是选中状态。有时候AS可能需要一点时间刷新缓存如果没立即出现可以尝试点击右下角的“Apply”或“OK”后重新打开。注意手动解压时务必确保ZIP包内的文件直接位于android-22文件夹下而不是嵌套了另一层android-22。即正确结构是platforms/android-22/android.jar错误结构是platforms/android-22/android-22/android.jar。后者会导致SDK Manager无法识别。5. 高级应用配置sdkmanager使用本地文件源对于需要批量部署或搭建内网镜像的场景手动一个个解压效率太低。更专业的做法是配置sdkmanager使用本地或内网的资源库。这需要你了解SDK仓库的目录结构。Google的官方SDK仓库结构大致如下可通过访问https://dl.google.com/android/repository/repository2-1.xml窥见- [repository root] - addon2-1.xml - package.xml - platform-22_r02.zip - platform-tools_r34.0.5-windows.zip - ... - addons/ - platforms/每个ZIP包都有一个对应的package.xml描述其元数据。搭建简易本地源的步骤下载所需的所有包在一台有外网权限的机器上使用sdkmanager --verbose下载或者根据repository2-1.xml列表手动下载所有需要的ZIP包和对应的XML文件。创建镜像目录结构在服务器上按照官方仓库的相同目录结构放置这些文件。例如将android-22.zip通常官方命名是platform-22_r02.zip这样的格式和它的package.xml放在镜像根目录。配置sdkmanager使用镜像找到SDK根目录下的cmdline-tools/latest/bin/sdkmanager。在调用时通过--proxy设置代理或者更彻底地修改其背后的配置文件。但更通用的方法是设置环境变量ANDROID_SDK_ROOT并配合一个本地的repositories.cfg文件。实际上对于离线安装更常用的命令是sdkmanager --install platforms;android-22 --verbose --sdk_root/path/to/your/sdk但此命令仍需网络。纯离线时可以“欺骗”一下将下载好的ZIP包重命名为sdkmanager期望的缓存文件名放在SDK目录下的.temp或cache文件夹中但这种方法很 hacky不推荐。更现实的方案使用--verbose模式查看下载链接然后用任何下载工具获取文件再执行上述手动安装步骤。对于团队可以编写一个脚本自动完成“下载-校验-解压到指定位置”的全过程。6. 疑难杂症排查从“Failed to create directory”到环境变量让我们集中火力解决开头提到的那个高频错误“安装android sdk显示failed to create directory”。根据我的经验排查链路应该如下第一步检查路径权限最常见现象在Windows上如果你将SDK路径设置在C:\Program Files或C:\Program Files (x86)下而没有以管理员身份运行Android Studio就会因权限不足导致创建目录失败。解决方案推荐更改SDK路径到用户目录在Android Studio的SDK设置中将Android SDK Location改到一个你有完全控制权的路径例如C:\Users\YourName\Android\Sdk或D:\Android\Sdk。这是最一劳永逸的方法。如果必须安装在系统目录则务必以管理员身份运行Android Studio。第二步检查路径字符串现象路径中包含中文、空格、括号等字符。例如D:\开发工具\Android Sdk (x86)。旧版本的Java或SDK工具在处理此类路径时可能出错。解决方案将SDK路径修改为全英文、无空格、无特殊字符的路径。例如D:\Android\Sdk。第三步检查磁盘空间与父目录现象目标磁盘已满或者你指定的路径如E:\Android\Sdk但E:\Android这个文件夹本身不存在。解决方案清理磁盘空间或手动创建完整的父目录结构。第四步关闭安全软件实时防护现象在安装过程中电脑上的杀毒软件如360、Windows Defender的实时保护可能会弹出拦截提示如果被自动阻止或你忽略了提示就会导致失败。解决方案暂时禁用实时保护完成SDK安装后再开启。或者在安全软件中为Android Studio、Javajava.exe等进程添加信任规则。第五步核对环境变量环境变量错误不会直接导致“创建目录失败”但会导致后续的一切命令如adb、gradle无法工作常常与安装问题混淆。ANDROID_HOME 与 ANDROID_SDK_ROOTANDROID_HOME是旧变量ANDROID_SDK_ROOT是新变量。建议两者都设置指向你的SDK根目录。如何设置Windows系统属性 - 高级 - 环境变量 - 新建系统变量。 变量名ANDROID_HOME和ANDROID_SDK_ROOT变量值D:\Android\Sdk你的实际路径如何设置Mac/Linux编辑~/.bashrc或~/.zshrc文件添加export ANDROID_HOME/Users/YourName/Library/Android/sdk export ANDROID_SDK_ROOT$ANDROID_HOME export PATH$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/emulator验证打开新终端输入echo $ANDROID_HOME或adb version看是否能正确输出。第六步使用命令行工具进行修复如果Android Studio的图形界面一直失败可以尝试使用更底层的命令行工具。下载独立的 Command Line Tools 。解压到任意位置例如D:\android-cmdline-tools。打开终端进入其bin目录。使用sdkmanager命令安装可以更清晰地看到错误信息sdkmanager --install platforms;android-33 --sdk_rootD:\Android\Sdk通过--sdk_root明确指定安装位置避免歧义。命令行输出的错误信息通常比GUI更详细。7. 关于HAXM、天地图SDK等热词的延伸解读在搜索“android-22”时你可能会关联看到“android studio 手动添加haxm sdk源”和“天地图 android sdk”这些热词。它们与平台包相关但属于不同的范畴。HAXMIntel Hardware Accelerated Execution Manager是什么英特尔提供的硬件加速器用于在Intel CPU的电脑上大幅提升Android模拟器的运行速度。与android-22的关系没有直接关系。你可以在安装任何API级别的平台后单独安装HAXM来加速该平台的模拟器。如果SDK Manager中找不到HAXM通常是因为你的CPU不是Intel而是AMD或者需要在主板BIOS中开启VT-x虚拟化支持。对于AMD CPU应使用“Windows Hypervisor Platform (WHPX)”或“AMD Virtualization (SVM)”。手动添加源通常不需要。HAXM可以通过SDK Manager的“SDK Tools”选项卡安装。如果因为网络问题无法安装应去Intel官网下载独立的HAXM安装程序手动安装而不是添加源。天地图 Android SDK是什么中国国家基础地理信息中心提供的官方地图服务SDK类似于Google Maps SDK的国产替代品常用于国内需要地图功能的应用。与android-22的关系完全没有关系。天地图SDK是一个第三方商业SDK你需要去其官方网站注册、申请密钥、下载SDK的JAR或AAR文件然后像集成其他第三方库一样将其添加到你的Android项目中。它的集成与你的compileSdkVersion比如22有关因为需要保证兼容性但两者是独立的产品。8. 最佳实践与版本管理建议经过上述折腾你应该能感受到手动管理SDK的痛点了。最后分享几点个人经验让你的开发环境更清爽、更稳定SDK路径标准化个人开发强烈建议将SDK安装在用户目录下例如~/Android/Sdk(Mac/Linux) 或C:\Users\YourName\Android\Sdk(Windows)。避免所有权限和路径问题。使用版本管理工具管理关键配置虽然SDK本身很大不适合放入Git但你可以将项目的local.properties文件其中指定了sdk.dir纳入版本管理并确保团队约定使用相同的相对路径或通过环境变量引用。对于Gradle Wrapper (gradlew) 和项目级别的gradle.properties配置一定要纳入版本管理这是保证构建一致性的关键。定期清理无用平台随着项目迭代旧平台比如android-16, android-19可能不再需要。定期通过SDK Manager卸载它们可以节省大量磁盘空间。在卸载前确认所有老项目都已升级或不再需要维护。为CI/CD环境制作SDK镜像对于Jenkins、GitLab CI等构建服务器最好的实践是使用Docker。创建一个预装了指定版本SDK、NDK、CMake等所有依赖的Docker镜像。这样每次构建都在一个纯净、一致的环境中开始彻底杜绝“环境差异”问题。你可以基于官方镜像如ubuntu:22.04编写Dockerfile使用sdkmanager --install命令在镜像构建时安装所需组件。理解compileSdkVersion,targetSdkVersion,minSdkVersion这是三个最重要的Gradle配置。compileSdkVersion告诉编译器用哪个版本的android.jar来检查你的代码。应尽可能使用最新的稳定版如34以获得最新的API检查和编译优化。targetSdkVersion你的应用适配的系统行为版本。它决定了应用在对应版本的设备上会启用哪些新特性或行为变更。升级它需要充分测试。minSdkVersion应用支持的最低系统版本。决定了你的应用能安装在多老的设备上。它限制了你能使用的API必须高于此版本的API才能用否则需要做兼容性判断。 手动放置的android-22.zip主要服务于compileSdkVersion和targetSdkVersion。手动处理一个android-22.zip看似是一个简单的文件操作但它背后串联起了Android开发环境配置、构建系统理解、团队协作和故障排查的完整链条。掌握它意味着你对开发工具链有了更深一层的控制力下次再遇到SDK相关的“玄学”问题时你就能有条不紊地深入文件系统和命令行去解决而不是仅仅依赖于IDE图形界面的重试按钮。本文还有配套的精品资源点击获取 Android SDK离线包android-22.zip详解：手动安装、环境配置与疑难排查
简介本资源是面向Android应用开发者的SDK平台组件包专为适配Android 5.1.1API级别22系统环境而设计适用于需要兼容Lollipop版本设备的中高级开发者及教学实训场景。压缩包共含2000个文件涵盖6003张PNG系统图标、1324份XML布局与配置资源、130页HTML格式API文档、91种字体文件ttf及4个核心JAR库如platform.jar完整支撑编译、调试、UI适配与源码查阅需求整体体积63.56MB结构清晰包含system-images、docs、sources、res等标准SDK平台目录。目前已有211人学习下载资源内含framework.aidl接口定义、color_fade_frag.frag着色器片段、accessibility_gestures.bin手势数据等典型Lollipop特性文件便于深入理解Material Design实现机制与系统级交互逻辑。1. 从“android-22.zip”说起一个被遗忘的SDK包意味着什么如果你在某个老旧的硬盘角落或者一个尘封的项目备份里翻到了一个名为“android-22.zip”的文件你的第一反应是什么是直接删除还是带着一丝好奇去探究它背后的故事对于很多刚接触Android开发不久的朋友或者那些一直在使用Android Studio的自动更新功能、从未手动处理过SDK的开发者来说这个文件可能显得陌生又古老。但恰恰是这些以版本号命名的压缩包构成了Android应用开发的基石。今天我们就来彻底拆解这个“android-22.zip”它不仅仅是Android 5.1Lollipop MR1系统镜像和平台工具的一个离线包更是一把钥匙能帮你理解Android SDK管理的底层逻辑解决那些让新手头疼的“网络失败”、“目录创建失败”等问题。简单来说Android SDK (SDK Platforms)-android-22.zip是Android SDK中“平台工具包”的一个特定版本API Level 22的离线安装包。在理想的网络环境下我们通过Android Studio的SDK Manager点点鼠标就能下载一切。但现实往往是骨感的公司内网限制、糟糕的网络代理配置、或者单纯地想为团队搭建一个统一的离线开发环境这时手动管理这些ZIP包就成了必备技能。理解它你就能摆脱对IDE网络下载的绝对依赖甚至在CI/CD流水线中实现SDK环境的快速部署。接下来我会带你从文件结构、使用场景到手动集成避坑完整走一遍。2. 解剖“android-22.zip”里面到底装了些什么当你解压这个ZIP文件后得到的并不是一个可以直接运行的应用程序而是一个遵循特定目录结构的“资源包”。这个结构是Android SDK Tools如sdkmanager能够识别并正确安装的关键。我们以android-22为例看看它的典型内容android-22/ ├── android.jar ├── framework.aidl ├── data/ │ ├── layoutlib.jar │ └── ... ├── skins/ │ └── ... ├── build.prop ├── source.properties └── ... (其他系统镜像文件如果包含的话)核心文件解读android.jar这是最核心的文件。它包含了针对API Level 22Android 5.1编译时所需的全部类库和API定义。当你在build.gradle中设置targetSdkVersion或compileSdkVersion为22时Gradle编译器就会使用这个JAR文件来检查你的代码语法、方法调用是否合法。它定义了你能“看到”和“调用”的所有系统API。framework.aidlAndroid接口定义语言文件。系统服务如电话、短信的接口描述就定义在这里用于跨进程通信IPC的代码生成。data/layoutlib.jar布局渲染库。Android Studio的布局预览Preview面板依赖这个库来在IDE中渲染出对应API级别的UI样式。如果没有它预览面板可能会报错或显示不正确。skins/包含Android模拟器的皮肤文件用于定义不同设备如Nexus 5、Pixel的模拟器外观。build.prop类似于Android设备的/system/build.prop文件定义了该平台版本的各种系统属性在构建和模拟器运行时会被读取。source.properties这个文件是SDK包的“身份证”。它里面记录了该包的Pkg.Revision修订版本号、Pkg.Path安装相对路径如platforms;android-22等元信息。SDK Manager完全依靠这个文件来识别和管理已安装的包。重要区分android-22.zipvssdk-tools-*.zip这是最容易混淆的地方。android-22.zip是平台Platform它提供编译和运行时的API框架。而sdk-tools-*.zip或platform-tools-*.zip是工具Tools里面包含的是adb、fastboot、sdkmanager这些命令行工具。它们是两个不同的组件通常需要分开下载和管理。当你遇到“安装android sdk显示failed to create directory”这类错误时问题往往出在工具链的安装或环境配置上而非平台包本身。3. 为什么需要手动处理离线SDK包四大典型场景在云端和高速网络普及的今天手动下载一个几百兆的ZIP包似乎有些“复古”。但以下场景中这项技能能救你于水火场景一封闭或受限的网络环境很多企业的开发网络出于安全考虑无法直接访问Google的官方仓库dl.google.com。Android Studio的SDK Manager会直接报错。这时运维人员通常会事先从外网下载好所需的SDK平台包和工具包放置在内网文件服务器或共享目录中。开发者就需要手动将这些ZIP包放置到正确的位置或者配置SDK Manager使用本地镜像源。场景二搭建统一、可复现的团队开发环境为了确保团队所有成员、以及构建服务器如Jenkins使用完全一致的SDK版本避免因SDK组件版本差异导致的“在我机器上是好的”这类问题。将核准版本的SDK平台包归档作为项目基础设施的一部分是实现环境标准化的有效手段。场景三历史项目的维护与构建你可能需要维护一个非常古老的应用其targetSdkVersion被锁定在了22。而最新版的Android Studio SDK Manager可能已经不再默认提供这个版本的下载或者在图形界面中隐藏得很深。拥有一个离线包就能随时恢复出准确的构建环境。场景四解决诡异的“Failed to create directory”错误这个错误在网络搜索中热度很高。它通常发生在权限不足你试图将SDK安装到系统保护目录如C:\Program Files下但没有以管理员权限运行Android Studio或命令行。路径包含特殊字符或空格SDK路径中含有中文字符、括号或空格某些旧版本工具处理不当。磁盘空间不足或路径不存在目标磁盘已满或者你指定了一个不存在的父目录。防病毒软件或安全软件拦截实时防护软件可能会阻止程序创建目录或写入文件。当自动安装失败时手动解压ZIP包到正确路径往往是绕过这些环境问题最直接粗暴且有效的方法。4. 手动安装“android-22.zip”的完整操作指南假设我们已经下载好了android-22.zip文件现在要将其手动集成到现有的Android SDK目录中。以下是详细步骤和原理说明。步骤1定位你的Android SDK根目录首先你需要知道SDK装在哪。打开Android Studio点击File - Settings - Appearance Behavior - System Settings - Android SDK。在Android SDK Location一栏显示的路径就是你的SDK根目录例如C:\Users\YourName\AppData\Local\Android\Sdk或/Users/YourName/Library/Android/sdk。步骤2确定正确的目标路径SDK目录有严格的子目录结构。平台包必须放在[SDK根目录]/platforms/下面。 因此android-22.zip解压后的内容应该整个放在[SDK根目录]/platforms/android-22/中。步骤3执行解压与放置在文件管理器中进入你的SDK根目录下的platforms文件夹。如果不存在就手动创建一个。将android-22.zip复制或移动到platforms文件夹旁边不是里面为了方便操作。右键点击ZIP文件选择“解压到当前文件夹”或使用命令行unzip android-22.zip。你会得到一个名为android-22的文件夹。现在将这个android-22文件夹移动到platforms文件夹内部。 最终结构应该是[SDK根目录]/platforms/android-22/android.jar, build.prop, ...步骤4验证安装手动放置后最好让SDK管理工具“知道”它的存在。方法A使用命令行工具推荐打开终端CMD, PowerShell, Bash进入SDK根目录下的cmdline-tools/latest/bin目录如果你安装了Command-line Tools。 执行命令./sdkmanager --list --verbose在输出的已安装包列表中仔细查找platforms;android-22。如果看到它并且状态显示为Installed说明识别成功。--verbose参数会显示安装路径你可以核对是否是你的手动路径。方法B查看Android Studio重启Android Studio再次进入Settings - Android SDK - SDK Platforms选项卡。你应该能在列表中找到 “Android 5.1 (API 22)”并且其前面的复选框是选中状态。有时候AS可能需要一点时间刷新缓存如果没立即出现可以尝试点击右下角的“Apply”或“OK”后重新打开。注意手动解压时务必确保ZIP包内的文件直接位于android-22文件夹下而不是嵌套了另一层android-22。即正确结构是platforms/android-22/android.jar错误结构是platforms/android-22/android-22/android.jar。后者会导致SDK Manager无法识别。5. 高级应用配置sdkmanager使用本地文件源对于需要批量部署或搭建内网镜像的场景手动一个个解压效率太低。更专业的做法是配置sdkmanager使用本地或内网的资源库。这需要你了解SDK仓库的目录结构。Google的官方SDK仓库结构大致如下可通过访问https://dl.google.com/android/repository/repository2-1.xml窥见- [repository root] - addon2-1.xml - package.xml - platform-22_r02.zip - platform-tools_r34.0.5-windows.zip - ... - addons/ - platforms/每个ZIP包都有一个对应的package.xml描述其元数据。搭建简易本地源的步骤下载所需的所有包在一台有外网权限的机器上使用sdkmanager --verbose下载或者根据repository2-1.xml列表手动下载所有需要的ZIP包和对应的XML文件。创建镜像目录结构在服务器上按照官方仓库的相同目录结构放置这些文件。例如将android-22.zip通常官方命名是platform-22_r02.zip这样的格式和它的package.xml放在镜像根目录。配置sdkmanager使用镜像找到SDK根目录下的cmdline-tools/latest/bin/sdkmanager。在调用时通过--proxy设置代理或者更彻底地修改其背后的配置文件。但更通用的方法是设置环境变量ANDROID_SDK_ROOT并配合一个本地的repositories.cfg文件。实际上对于离线安装更常用的命令是sdkmanager --install platforms;android-22 --verbose --sdk_root/path/to/your/sdk但此命令仍需网络。纯离线时可以“欺骗”一下将下载好的ZIP包重命名为sdkmanager期望的缓存文件名放在SDK目录下的.temp或cache文件夹中但这种方法很 hacky不推荐。更现实的方案使用--verbose模式查看下载链接然后用任何下载工具获取文件再执行上述手动安装步骤。对于团队可以编写一个脚本自动完成“下载-校验-解压到指定位置”的全过程。6. 疑难杂症排查从“Failed to create directory”到环境变量让我们集中火力解决开头提到的那个高频错误“安装android sdk显示failed to create directory”。根据我的经验排查链路应该如下第一步检查路径权限最常见现象在Windows上如果你将SDK路径设置在C:\Program Files或C:\Program Files (x86)下而没有以管理员身份运行Android Studio就会因权限不足导致创建目录失败。解决方案推荐更改SDK路径到用户目录在Android Studio的SDK设置中将Android SDK Location改到一个你有完全控制权的路径例如C:\Users\YourName\Android\Sdk或D:\Android\Sdk。这是最一劳永逸的方法。如果必须安装在系统目录则务必以管理员身份运行Android Studio。第二步检查路径字符串现象路径中包含中文、空格、括号等字符。例如D:\开发工具\Android Sdk (x86)。旧版本的Java或SDK工具在处理此类路径时可能出错。解决方案将SDK路径修改为全英文、无空格、无特殊字符的路径。例如D:\Android\Sdk。第三步检查磁盘空间与父目录现象目标磁盘已满或者你指定的路径如E:\Android\Sdk但E:\Android这个文件夹本身不存在。解决方案清理磁盘空间或手动创建完整的父目录结构。第四步关闭安全软件实时防护现象在安装过程中电脑上的杀毒软件如360、Windows Defender的实时保护可能会弹出拦截提示如果被自动阻止或你忽略了提示就会导致失败。解决方案暂时禁用实时保护完成SDK安装后再开启。或者在安全软件中为Android Studio、Javajava.exe等进程添加信任规则。第五步核对环境变量环境变量错误不会直接导致“创建目录失败”但会导致后续的一切命令如adb、gradle无法工作常常与安装问题混淆。ANDROID_HOME 与 ANDROID_SDK_ROOTANDROID_HOME是旧变量ANDROID_SDK_ROOT是新变量。建议两者都设置指向你的SDK根目录。如何设置Windows系统属性 - 高级 - 环境变量 - 新建系统变量。 变量名ANDROID_HOME和ANDROID_SDK_ROOT变量值D:\Android\Sdk你的实际路径如何设置Mac/Linux编辑~/.bashrc或~/.zshrc文件添加export ANDROID_HOME/Users/YourName/Library/Android/sdk export ANDROID_SDK_ROOT$ANDROID_HOME export PATH$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/emulator验证打开新终端输入echo $ANDROID_HOME或adb version看是否能正确输出。第六步使用命令行工具进行修复如果Android Studio的图形界面一直失败可以尝试使用更底层的命令行工具。下载独立的 Command Line Tools 。解压到任意位置例如D:\android-cmdline-tools。打开终端进入其bin目录。使用sdkmanager命令安装可以更清晰地看到错误信息sdkmanager --install platforms;android-33 --sdk_rootD:\Android\Sdk通过--sdk_root明确指定安装位置避免歧义。命令行输出的错误信息通常比GUI更详细。7. 关于HAXM、天地图SDK等热词的延伸解读在搜索“android-22”时你可能会关联看到“android studio 手动添加haxm sdk源”和“天地图 android sdk”这些热词。它们与平台包相关但属于不同的范畴。HAXMIntel Hardware Accelerated Execution Manager是什么英特尔提供的硬件加速器用于在Intel CPU的电脑上大幅提升Android模拟器的运行速度。与android-22的关系没有直接关系。你可以在安装任何API级别的平台后单独安装HAXM来加速该平台的模拟器。如果SDK Manager中找不到HAXM通常是因为你的CPU不是Intel而是AMD或者需要在主板BIOS中开启VT-x虚拟化支持。对于AMD CPU应使用“Windows Hypervisor Platform (WHPX)”或“AMD Virtualization (SVM)”。手动添加源通常不需要。HAXM可以通过SDK Manager的“SDK Tools”选项卡安装。如果因为网络问题无法安装应去Intel官网下载独立的HAXM安装程序手动安装而不是添加源。天地图 Android SDK是什么中国国家基础地理信息中心提供的官方地图服务SDK类似于Google Maps SDK的国产替代品常用于国内需要地图功能的应用。与android-22的关系完全没有关系。天地图SDK是一个第三方商业SDK你需要去其官方网站注册、申请密钥、下载SDK的JAR或AAR文件然后像集成其他第三方库一样将其添加到你的Android项目中。它的集成与你的compileSdkVersion比如22有关因为需要保证兼容性但两者是独立的产品。8. 最佳实践与版本管理建议经过上述折腾你应该能感受到手动管理SDK的痛点了。最后分享几点个人经验让你的开发环境更清爽、更稳定SDK路径标准化个人开发强烈建议将SDK安装在用户目录下例如~/Android/Sdk(Mac/Linux) 或C:\Users\YourName\Android\Sdk(Windows)。避免所有权限和路径问题。使用版本管理工具管理关键配置虽然SDK本身很大不适合放入Git但你可以将项目的local.properties文件其中指定了sdk.dir纳入版本管理并确保团队约定使用相同的相对路径或通过环境变量引用。对于Gradle Wrapper (gradlew) 和项目级别的gradle.properties配置一定要纳入版本管理这是保证构建一致性的关键。定期清理无用平台随着项目迭代旧平台比如android-16, android-19可能不再需要。定期通过SDK Manager卸载它们可以节省大量磁盘空间。在卸载前确认所有老项目都已升级或不再需要维护。为CI/CD环境制作SDK镜像对于Jenkins、GitLab CI等构建服务器最好的实践是使用Docker。创建一个预装了指定版本SDK、NDK、CMake等所有依赖的Docker镜像。这样每次构建都在一个纯净、一致的环境中开始彻底杜绝“环境差异”问题。你可以基于官方镜像如ubuntu:22.04编写Dockerfile使用sdkmanager --install命令在镜像构建时安装所需组件。理解compileSdkVersion,targetSdkVersion,minSdkVersion这是三个最重要的Gradle配置。compileSdkVersion告诉编译器用哪个版本的android.jar来检查你的代码。应尽可能使用最新的稳定版如34以获得最新的API检查和编译优化。targetSdkVersion你的应用适配的系统行为版本。它决定了应用在对应版本的设备上会启用哪些新特性或行为变更。升级它需要充分测试。minSdkVersion应用支持的最低系统版本。决定了你的应用能安装在多老的设备上。它限制了你能使用的API必须高于此版本的API才能用否则需要做兼容性判断。 手动放置的android-22.zip主要服务于compileSdkVersion和targetSdkVersion。手动处理一个android-22.zip看似是一个简单的文件操作但它背后串联起了Android开发环境配置、构建系统理解、团队协作和故障排查的完整链条。掌握它意味着你对开发工具链有了更深一层的控制力下次再遇到SDK相关的“玄学”问题时你就能有条不紊地深入文件系统和命令行去解决而不是仅仅依赖于IDE图形界面的重试按钮。本文还有配套的精品资源点击获取