Android开发环境搭建：JDK+Eclipse+SDK+ADT配置与排错

简介《软件学院移动应用软件开发技术实验报告》面向软件学院移动应用开发课程学生及Android入门者围绕环境搭建、Activity运用与UI设计三个实验环节展开帮助读者按实验报告流程完成工具配置与基础应用练习。压缩包内为1个doc文档约1.63MB内容以实验目的、要求、操作步骤、结果记录和截图粘贴页为主便于直接参照撰写与整理课程实验。报告覆盖JDK安装与环境变量配置、Eclipse与Android SDK在线/离线安装、ADT插件部署以及Activity生命周期、页面跳转、Intent传值和TextView、Button、ImageView、LinearLayout、RelativeLayout、GridLayout等基础控件与布局的使用。已有768人学习适合需要完成Android开发入门实验、补齐环境配置细节或参考实验报告结构的学生使用。1. Android 系统环境搭建JDK Eclipse SDK 这套老组合现在怎么装某高校的移动应用开发实验课第一个实验经常是 Android 系统环境搭建要求交 JDK 目录截图、Eclipse 界面截图、SDK Manager 界面截图和装了 ADT 之后的 Eclipse 截图。移动应用软件开发这四个字写在实验报告封面上挺轻巧落到机器上就是 JDK、Eclipse、Android SDK、ADT 四个组件按固定顺序装、按固定关系配中间任何一步错位后面全是连锁反应。最典型的反直觉版本坑Eclipse 下的是 32 位压缩包JDK 装的是 64 位双击 Eclipse 弹一个Failed to load the JNI shared library就没下文了很多人会以为是自己少装了插件重装一下午还在原地。这套环境解决的是「在一台 Windows 7 的老机器上把 Android 工程跑起来」这件事编译器、IDE、SDK、ADT 插件各就各位之后Activity 跳转、Intent 传值、LinearLayout 嵌套这些实验才有得做。适合三类人要交实验报告的学生、要给老项目复现构建环境的人以及手上只有一台旧笔记本、想把 Android 开发链路重新跑通的人。下面按我实际装的顺序写每一步都给了能直接抄的命令或配置。2. 装 JDK 与配 JAVA_HOME版本、路径、三个变量怎么写JDK 是这套环境的地基装错了后面全废。讲义上写的是 JDK SE 6.0 以上这个「以上」范围很宽实际能选到哪个版本取决于你后面配的 Eclipse 是 3.7 还是 4.x。2.1 JDK 版本怎么选1.6 是底线1.7 是分水岭实验讲义给的底线是 1.6我一般在老机器上装JDK 6u456 系列的最后一个公开更新版或者JDK 7u80。理由很实际配套的 Eclipse Indigo3.7在 JDK 8 上会出现Unsupported major.minor version 52.0这类编译级别不匹配的报错而 ADT 那一批插件本身也是按 JDK 6/7 的 API 编的。JDK 版本配套 Eclipse兼容情况备注JDK 6u45Eclipse Indigo 3.7 (32 位)稳定讲义同款组合最省心JDK 7u80Eclipse Indigo 3.7 (32 位)可用需在 Eclipse 里把编译级别设成 1.7JDK 8Eclipse Indigo 3.7容易出问题编译级别、插件签名都可能报错比版本更要紧的是位数。Eclipse 压缩包文件名里的win32就是 32 位win32-x86_64才是 64 位。32 位 Eclipse 必须配 32 位 JDK这是硬绑定的不是「差不多能用」。判断标准是任务管理器里 Eclipse 进程后面有没有*32后缀或者直接看java -version输出里有没有64-Bit Server VM。我一般会先确认位数再动手省得后面反复卸载。2.2 安装路径空格、中文和过深的目录都是隐患JDK 默认往C:\Program Files\Java\下装这个路径带空格对 2013 年前后的一批构建脚本不太友好而 ADT 建工程时如果 SDK 路径里有中文某些版本会直接在R.java生成阶段失败报错信息还很难懂。我固定的放法是:: 三个目录分开全英文、无空格、层级尽量浅 C:\Java\jdk1.6.0_45 D:\dev\eclipse D:\dev\android-sdk-windows这么放的原因有三个。一是 JDK 更新换代频繁C:\Java下可以并存 6、7、8 三个版本切换只改JAVA_HOME就行不用卸载重装。二是 Eclipse 是绿色包换版本直接换个目录旧目录留着当后悔药。三是 Android SDK 后面的目录层级很深platforms\android-8\data\res\...Windows 的 260 字符路径限制很容易被顶穿根目录越浅越安全。2.3 JAVA_HOME、Path、CLASSPATH 三个变量的写法环境变量是这套环境里最容易写错、又最难看出错在哪的一步。图形界面路径是「计算机 → 右键属性 → 高级系统设置 → 环境变量」我一般直接用setx写写完开新窗口验证避免旧 cmd 窗口缓存的老值骗人。:: 需管理员权限打开 cmd/M 表示写系统变量不加就是写当前用户变量 setx JAVA_HOME C:\Java\jdk1.6.0_45 /M setx PATH %PATH%;%JAVA_HOME%\bin /M setx CLASSPATH .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar /M三个变量的作用不一样写错方式也不一样。JAVA_HOME的值是 JDK 的根目录不能带\bin末尾不能加分号不能加引号setx 里那对引号是给命令用的写进注册表时会被去掉。写成C:\Java\jdk1.6.0_45\bin的话Path 里再拼一次\bin就成了bin\binjavac必然找不到。PATH是把%JAVA_HOME%\bin追加进去让java、javac、jar这些命令在任意目录下能直接调用。注意是追加不是覆盖覆盖掉系统自带的 Path 会让一堆系统命令消失这是真正的翻车现场。CLASSPATH开头那个.点表示当前目录不加的话java test会报Could not find or load main class。dt.jar和tools.jar是 JDK 自带的两包编译期的一些内部类要靠它老讲义里都要求加上。提示setx有用长度限制Path 超过 1024 字符会被截断。改之前先echo %PATH%看一眼把没用的路径清掉再写。2.4 用 test.java 验证编译与运行代码写完不算完得让编译器真的吐出 class 文件。讲义要求写一个test.java并截图运行结果我建议把内容改成能打印版本号的这样截图本身就是证据。public class test { public static void main(String[] args) { // 打印 JDK 版本和安装路径一眼能对上环境变量配置 System.out.println(JDK version: System.getProperty(java.version)); System.out.println(JDK home: System.getProperty(java.home)); System.out.println(编译运行链路正常); } }放到任意目录比如D:\work\javatest然后在 cmd 里执行cd /d D:\work\javatest javac -encoding UTF-8 test.java java testjavac是编译器负责把.java编译成.classjava是运行器后面跟的是类名不带.class后缀。-encoding UTF-8这个参数非常关键Windows 下 javac 默认按 GBK 读源码如果你的文件是 UTF-8 保存且里面有中文比如上面那行「编译运行链路正常」不加这个参数就会编译出一串乱码或者直接报「编码 GBK 的不可映射字符」。执行成功的标志是目录下多出test.class并且控制台打印出 JDK 版本。如果java -version能出版本号但javac报「不是内部或外部命令」说明JAVA_HOME\bin只加进了用户变量而当前窗口是管理员权限开的读的是系统变量——这是环境变量这一节最常见的坑开个普通 cmd 窗口重试就行。3. Eclipse 解压与 ADT 插件安装把 SDK 认进来Eclipse 本身不需要安装程序压缩包解开就能用麻烦的都在后面那一步 ADT。ADT 是 Android Development Tools 的缩写装上它 Eclipse 才会多出 Android 工程模板、SDK 面板和 AVD 管理器。3.1 Eclipse 版本与位数的对应关系讲义里点名的是Eclipse IDE for Java EE Developers的eclipse-java-indigo-SR2-win32.zip也就是 Indigo3.7SR2 的 32 位版本。选 Java EE 版而不是 Java SE 版是因为 EE 版自带 XML 编辑器和 Web 相关插件编辑AndroidManifest.xml和布局文件时体验好不少。三个变量要一起对齐Eclipse 位数、JDK 位数、Windows 位数。三者不匹配时最典型的两句报错Failed to load the JNI shared library C:\Java\jdk1.6.0_45\bin\..\jre\bin\client\jvm.dll—— 32 位 Eclipse 配了 64 位 JDK。JVM terminated. Exit code13—— 同上另一个表现形式。这两句基本可以画等号看到其中一个就去查位数不用怀疑别的。判断 Eclipse 位数最快的方法是看解压目录里的plugins下有没有org.eclipse.equinox.launcher.win32.win32.x86_1.x.x.jar带x86_64的是 64 位。3.2 解压目录、workspace 与 eclipse.ini 里的 -vm解压到D:\dev\eclipse然后有几个配置项值得在第一次启动前就改掉省得后面来回折腾。一是workspace工作空间。第一次启动会弹框让你选默认在C:\Users\你的用户名\workspace这个路径带中文用户名的话建工程容易出玄学问题。我一般单独给一个D:\work\workspace全英文方便备份和迁移——workspace 目录整个拷走工程就跟着走了。二是eclipse.ini里的-vm参数。如果机器上装过多个 JDKPATH里排在前面的那个会被 Eclipse 拿去用你改了JAVA_HOME它可能根本不认。显式指定能一劳永逸-startup plugins/org.eclipse.equinox.launcher_1.2.0.v20110502.jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.100.v20110502 -product org.eclipse.epp.package.jee.product --launcher.XXMaxPermSize 256M -showsplash org.eclipse.platform -vm C:\Java\jdk1.6.0_45\bin\javaw.exe -vmargs -Dosgi.requiredJavaVersion1.6 -Xms128m -Xmx512m-vm必须单独占一行路径写在下一行而且必须写在-vmargs之前。写成-vm C:\Java\...同一行是不生效的Eclipse 会默默忽略你还会以为是自己 JDK 装错了。-Xmx512m是堆上限老机器内存小的话 512 够用编译大工程再往上加加太大会让 Eclipse 启动变慢。三是启动后第一次进Window → Preferences → General → Workspace把Text file encoding设成 UTF-8。这个不改以后工程里出现中文的地方全是乱码改起来是全局性的麻烦。3.3 通过 Install New Software 装 ADTADT 是走 Eclipse 的插件仓库装的入口在Help → Install New Software。点Add弹出Add Repository对话框Name随便填但要能认出来写ADT就行Location填 ADT 的更新站点地址讲义上给的是dl-ssl.google.com/android/eclipse/那一条注意别把dl打成dll一个字母之差就是连接超时。确定之后 Eclipse 会去拉仓库索引等它把Developer Tools这个分组列出来。这里有个能省十几分钟的勾选项对话框下方有个Contact all update sites during install to find required software安装 ADT 时把它取消掉。勾着的话 Eclipse 会去挨个访问所有已注册的更新站点找依赖网速慢的时候能卡到你以为死机。ADT 的依赖其实都在它自己的仓库里不勾也能装完。勾上Developer Tools一路Next → Next → Accept License → Finish。安装过程几分钟结束时弹重启提示选Restart Now。别嫌麻烦不重启插件不会生效菜单里也看不到 Android 相关的项。3.4 指定 SDK Location让 ADT 认到 SDK重启之后ADT 装好了但它还不知道 SDK 在哪这一步落在Window → Preferences → Android。SDK Location里填 SDK 的根目录比如D:\dev\android-sdk-windows然后Apply → OK。填对了的话下面那个列表会直接列出已经下载的 API 版本和对应路径填错了就是空白或者提示找不到tools目录。判断 ADT 有没有装成功有两个快捷信号一是Preferences左侧树里出现了Android这一项二是工具栏上多了个带小机器人图标的 SDK Manager 按钮。两个都没有说明插件压根没装上回去看Help → About Eclipse → Installation Details里有没有Android DDMS和Android Development Tools两条记录。注意SDK Location 建议用「浏览」按钮选目录而不是手打路径手打很容易多一个反斜杠或少一个-windows后缀而 ADT 对这两种错误的提示都是同一句「SDK 未找到」排查起来很费劲。4. Android SDK 的在线与离线安装Manager 拉不动就走备份路线SDK 是这套环境里体积最大、也最容易卡住的一环。讲义给了在线和离线两条路我给的建议是先试在线半小时没动静就转离线不要在一条路上耗一整个下午。4.1 在线安装SDK Manager 里哪些项必须勾解开android-sdk_r16-windows.zip到D:\dev\android-sdk-windows目录里能看到SDK Manager.exe和AVD Manager.exe两个可执行文件双击前者进入Android SDK and AVD Manager。左侧选Available packagesRefresh一次然后按下面这几项勾包名作用是否必装Android SDK Tools, revision 16SDK 的核心工具含 aapt、dx必装Android SDK Platform-tools, revision 8adb、fastboot 所在必装SDK Platform Android 2.2, API 8编译目标平台的 android.jar必装Google APIs by Google Inc., Android API 8含地图等扩展库建议装Samples for SDK API 8官方示例工程可选Android Compatibility package低版本兼容包可选SDK Platform和Google APIs的区别值得说一句前者是纯 Android 框架后者在框架之上加了 Google 的扩展库。实验里只用 Activity 和布局的话装前者就够但工程里如果targetSdk选了 Google APIs缺了它编译会报android.jar里找不到类。勾完点Install Selected接受协议等下载。这一步成败很大程度取决于网络卡住的处理方式见第 5 章。4.2 离线安装先建目录骨架再解压对应包离线安装的核心逻辑是把「下载」和「安装」拆开。SDK Manager 之所以能识别一个包是因为它按固定目录名去扫目录对了、里面内容对了它就当这个包装好了。第一步是在 SDK 根目录下手动建五个文件夹cd /d D:\dev\android-sdk-windows mkdir platforms mkdir docs mkdir samples mkdir usb_driver mkdir market_licensing这五个目录名是 SDK Manager 扫描时写死的大小写敏感、不能有空格少一个它就在对应分类下显示为空。platforms放各版本平台的android.jar和资源docs放离线文档samples放示例工程usb_driver放 Windows 下的真机驱动market_licensing放市场授权相关组件。第二步是把下载下来的 zip 按类型解压进对应目录。判断规则很简单文件名里带platform或android-数字的解压到platforms下带docs的进docs带samples的进samples带usb_driver的进usb_drivertools_r06-windows.zip这种要解压到 SDK根目录它会覆盖掉原来的tools文件夹。以android-2.2_r01-windows.zip为例解压后应该形成platforms\android-2.2\这个结构里面能看到android.jar、data、templates、package.xml这几样。如果解压出来是platforms\android-2.2_r01\这种带版本号后缀的目录名SDK Manager 是认不出的得手动改成android-2.2。4.3 让 SDK Manager 认到手工放进去的包目录对了还不够SDK Manager 判断一个包有没有装看的是每个包目录下的package.xml。手工解压的包如果缺这个文件界面上就会显示成「未安装」你明明已经把文件放进去了。platforms\android-2.2\package.xml的内容大致是下面这个结构?xml version1.0 encodingUTF-8? ns2:repository xmlns:ns2http://schemas.android.com/repository/android/common/01 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance !-- path 要和实际目录对应platforms 下就叫 platforms;android-8 -- localPackage pathplatforms;android-8 type-details xsi:typens2:platformDetailsType api-level8/api-level /type-details revision major1/major /revision display-nameAndroid SDK Platform 2.2/display-name /localPackage /ns2:repositoryapi-level要填对2.2 对应的是 8填成 10 的话 SDK Manager 会把它当成 2.3.3 列出来。path里的分号是 SDK Manager 内部的层级分隔符platforms;android-8表示platforms分类下名为android-8的包。不过说实话这个 XML 的字段在不同 revision 之间有过调整照抄容易踩坑。我一般会用的更稳的做法是找一台能在线装好的机器或者用能联网的环境先让 SDK Manager 正常装一次然后把整个platforms目录打包拷过来。目录带着package.xml一起过去SDK Manager 一刷新就认了。这个思路在离线装机场景里通用比手写 XML 可靠得多。4.4 创建 AVD 并启动第一次模拟器SDK 装完只是有了编译能力要在屏幕上看到界面还得有模拟器。AVD Manager → New填四项Name用android22这种不带空格的Target选Android 2.2 - API Level 8SD Card Size填 64 或者 128MB不填的话某些版本会报错Skin选WVGA800。创建完回到列表里点Start第一次启动会慢冷启动两三分钟很正常看到解锁界面就算成功。如果黑屏超过五分钟先别急着重装去任务管理器看emulator.exe的 CPU 占用一直在跑说明它在解压镜像占用降到 0 才是真的卡死。5. 环境搭完跑不起来5 个高频故障的排查顺序这一节按「现象 → 原因 → 解决」写都是这套组合里反复出现的故障。排查顺序建议从上往下因为前面的故障会让后面的现象变得不可信。5.1 现象javac不是内部或外部命令现象java -version能出版本号javac -version报「不是内部或外部命令也不是可运行的程序」。原因PATH里只加了jre\bin或者某个单独目录没加%JAVA_HOME%\bin。另一种情况是加了但对当前窗口不生效——cmd 窗口会缓存启动时的环境变量setx写完不重开窗口是看不到的。解决先echo %PATH%看输出里有没有 JDK 的bin没有就重写有的话关掉当前 cmd重新开一个再试。还不行就看是不是把 Path 写成了覆盖模式系统目录被冲掉了——这种情况where命令都会失效需要用绝对路径C:\Windows\System32\cmd.exe打开窗口来修。5.2 现象ADT 装完重启Eclipse 报 SDK not found现象Preferences → Android里 SDK Location 填了路径点 OK 后弹框提示找不到 SDK或者下方的包列表一直是空的。原因路径填错是最常见的多一个反斜杠、少一个目录层级、填到了tools子目录而不是 SDK 根目录都会这样。第二个原因是 SDK 目录确实不完整手工解压时没建platforms和toolsADT 会认为这不是一个合法的 SDK 根目录。解决填路径时用「浏览」按钮选别看手打。确认根目录下同时存在tools、platform-tools、platforms三个文件夹——这三个是 ADT 判断合法性的最低要求缺一个都不认。platform-tools如果没装用 SDK Manager 单独装一次 Platform-tools 就会自动生成。5.3 现象SDK Manager 卡在 Fetching URL 不动现象打开Available packages点 Refresh界面一直显示Fetching URL: ...进度条不动等十几分钟也没反应。原因这一条通常是网络层面的SDK Manager 要走 HTTPS 去拉仓库索引。r16 那个年代的版本对证书和跳转的处理比较弱网络环境稍复杂就会挂住。解决先在Settings里把Force https://...那个勾选切换一下勾上或取消两个方向都试再 Refresh。如果还是不行就走 4.2 的离线路线——把需要的包在别处下好按目录结构放进去。这是这套环境里最值得提前准备后路的一环别把时间耗在等进度条上。5.4 现象新建 Android 工程R.java不生成现象工程建好了gen目录下空着或者变红叉MainActivity.java里R.layout.activity_main一片红。原因R.java是编译期自动生成的不生成说明资源编译那一步失败了。常见触发点有三个res下有文件名带大写字母或中文字符资源文件名只允许小写字母、数字和下划线res/values下的 XML 有语法错误工程的targetSdk指向了一个没装的 API 版本。解决先看Problems视图资源相关的错误都会列出来照着改文件名。然后Project → Clean重新构建一次勾上Build Automatically。如果还是不行检查Project → Properties → Android里勾选的 Target 是不是已经安装了——没装的 Target 会让整个资源编译链失败而报错偏偏不指向这里。5.5 现象模拟器起来了但adb devices列表为空现象模拟器窗口正常显示但命令行执行adb devices只输出一行List of devices attached下面是空白。原因adb命令不是当前目录下的用的是别的版本或者adb服务在启动模拟器之前就已经跑起来了端口对不上。解决确认用的是platform-tools目录下的那个adb.exe最稳的是cd进去再执行cd /d D:\dev\android-sdk-windows\platform-tools然后adb kill-server再adb devices重启服务后一般能认到emulator-5554。真机连不上则是驱动问题usb_driver目录下的驱动装上再打开设备的调试模式。6. 装完怎么验证这套环境真的能跑通环境装完最忌讳的是「看起来都装上了」就交报告。截图能骗人编译不能。我给自己定的验证顺序是四层一层不通过就不往下走。第一层命令行层。开一个新的 cmd 窗口不是之前那个依次执行java -version、javac -version、adb version三条都要出版本号。java和javac的版本号必须一致出现1.6.0_45和1.7.0_80混搭说明 Path 里排在前面的不是你要的那个 JDK。第二层Eclipse 层。启动 Eclipse确认Preferences里有Android项、工具栏上有 SDK Manager 图标、Window → Android SDK and AVD Manager能正常打开。这三样齐了说明 ADT 和 SDK Location 都配对了。第三层编译层。新建一个 Android Application ProjectProject → Properties → Android里 Target 选 API 8改一下TextView的文字保存看gen目录下的R.java有没有重新生成。这一步是在验证 aapt 和资源编译链。第四层运行层。写一个最小的 Activity 跳转验证 Intent 这条链路真的通// MainActivity 里放一个按钮点击启动 OtherActivity Button btn (Button) findViewById(R.id.button1); btn.setOnClickListener(new View.OnClickListener() { public void onClick(View v) { // 显式 Intent直接指定目标 Activity 的类 Intent intent new Intent(MainActivity.this, OtherActivity.class); // 带一个键值对过去OtherActivity 里用 getIntent().getStringExtra(word) 取 intent.putExtra(word, 验证通过); startActivity(intent); } });跑起来点一下按钮能跳到另一个界面并显示「验证通过」这套环境就是真的活了。带上putExtra和getStringExtra这一对是因为 Activity 之间传值涉及 Bundle 序列化只有它通了后面的实验二才算有基础。这套环境的坑我踩过不止一次。从那以后我每次装完都会把第一层到第四层强制走一遍哪怕只是重装了一个 JDK 小版本也一样——因为最容易出问题的永远不是全新安装而是「只改了一点点」的那种。你要是也在装这套老组合照这个顺序走一遍能省掉大半反复卸载重装的时间。希望帮到你。本文还有配套的精品资源点击获取