接手一个用 Eclipse 开发的 Android 老工程第一眼看到的就是欢迎界面——它决定了用户对 App 的第一印象也决定了你后面几个小时的调试心情。这次要拆的是「博学谷」这个在线学习类 App 的第一屏基于 Eclipse ADT 的 Android 欢迎界面实战。别小看这一屏它牵扯到工程环境搭建、资源目录适配、Activity 生命周期控制、冷启动主题设置、版本号动态读取这一整套东西。适合三类人看还在维护 Eclipse 老项目的同学、刚入门 Android 想搞清楚「一个 App 从点图标到进主页中间发生了什么」的新手以及需要给老工程做启动页改造的开发者。我会按我自己做的顺序把每一步的取舍和踩过的坑都摊开讲。1. 项目整体设计与思路拆解1.1 为什么这个实战项目值得用 Eclipse 完整走一遍现在新建 Android 项目绝大多数人直接开 Android StudioGradle 一跑依赖一拉十分钟出包。那为什么还要用 Eclipse 做一遍欢迎界面我的答案很直接因为 Eclipse ADT 这套流程能把 Android 的构建链路暴露在你面前。Gradle 把这些东西全封装了你出错了只看到一行红字而在 Eclipse 里你要亲手面对aapt打包资源、dx转换字节码、apkbuilder组装 APK 这一串工具哪一个步骤出问题报错都非常直白地怼在你脸上。具体到「博学谷」这个项目它是典型的教学演示型工程体量小、模块清晰非常适合用来观察启动流程。欢迎界面又是整个 App 的入口 Activity它启动得早、依赖得少是理解AndroidManifest注册机制、Intent跳转、Application初始化时机的最佳样本。你在这一屏上踩过的坑后面做任何一个新页面都会再遇到一遍。我把两套工具链的差异整理成一张表方便你判断自己该用哪套对比维度Eclipse ADTAndroid Studio构建方式基于 Ant / ADT 自定义构建配置写在 project.properties基于 Gradle配置写在 build.gradle依赖管理手动导入 jar 到 libs 目录并 Add to Build PathMaven 坐标自动拉取编译速度小工程增量编译快改一个类几秒出包首次同步慢之后增量尚可报错可读性底层工具报错信息原始但直指问题包装过一层有时需要看 Gradle 日志现状官方已停止维护 ADT 插件官方主推持续更新看懂这张表你就明白了Eclipse 适合学习原理和维护历史工程新项目没必要硬上。我的建议是如果你只是为了交一份课程作业或者修一个老项目里的 bug用 Eclipse 就对了如果要从零做一个上线的产品直接上 Android Studio不要跟自己的时间过不去。1.2 博学谷欢迎界面的需求边界在哪里做任何一屏之前先把「它到底要干什么」写清楚不然后面会无限加需求。博学谷的欢迎界面我给它划的边界是这样的展示品牌居中或偏上位置放 Logo底部放一句 Slogan让用户知道打开的是哪个 App。显示版本号右下角或底部居中显示当前的versionName方便用户反馈问题时说清楚自己用的哪一版这是客服环节最省事的做法。停留并跳转停留 1.5 到 3 秒之间自动跳到主界面。太短用户看不清 Logo太长用户会觉得卡。首次启动分流第一次安装打开时理论上应该先走引导页再进主页非首次启动直接进主页。这一步在「一」里可以先用一个开关预留位置。屏蔽返回欢迎页上按物理返回键不应该退出到桌面再重进正常做法是直接不响应。这五条里前两条是「看得见」的需求后三条是「看不见」的逻辑需求。很多新手只做了前两条结果交上去被问「为什么按返回键会重开一遍」这就是需求边界没想全。1.3 工程目录结构与资源命名规划Eclipse 的 Android 工程目录和 Android Studio 差别挺大先把结构记住后面找文件才不会迷路BoXueGu/ ├── src/ 源码目录包名下的 java 文件 │ └── com/boxuegu/app/ │ ├── SplashActivity.java │ └── MainActivity.java ├── gen/ 自动生成R.java 在这里不要手改 ├── assets/ 原样打包的原始资源比如本地 html ├── libs/ 第三方 jar 放这里需要手动 Add to Build Path ├── res/ │ ├── drawable-hdpi/ 高密度切图 │ ├── drawable-xhdpi/ 超高密度切图 │ ├── layout/ 布局 xml │ ├── values/ strings.xml、colors.xml、styles.xml │ └── values-v11/ 分版本的主题覆盖 ├── AndroidManifest.xml 四大组件注册与权限声明 └── project.properties 编译目标 SDK 版本资源命名这块我踩过坑必须强调。团队协作时如果命名随心所欲一个月后你自己都认不出来pic1.png是干嘛的。我的习惯是加类型前缀ic_表示图标类如ic_logo_boxuegu.pngbg_表示背景类如bg_splash.pngbtn_表示按钮类如btn_skip_normal.pngtext_表示文案色值如text_gray_light还有密度目录的换算关系这个直接影响你的图会不会糊密度目录缩放倍数建议切图尺寸基准drawable-mdpi1.0x基准尺寸drawable-hdpi1.5x基准 × 1.5drawable-xhdpi2.0x基准 × 2drawable-xxhdpi3.0x基准 × 3一张 Logo 在 mdpi 下是 120×120那 hdpi 就出 180×180xhdpi 出 240×240。你要是只放一张 120×120 在 hdpi 目录里在 1080P 的机器上就会被系统拉伸边缘直接发虚。2. 开发环境搭建与工程创建要点2.1 Eclipse 与 ADT 插件的版本搭配逻辑这一步是最容易劝退新手的因为版本不匹配会冒出各种莫名其妙的报错。我实测下来比较稳的一套组合是Eclipse 4.4 或 4.5也就是 Luna / MarsADT 插件 23.0.6Android SDK Tools 25.2.5Build Tools 23.0.3JDK 用 1.7。为什么强调 JDK 1.7 而不是 1.8这是整个环境里最坑的一点。ADT 里的dx工具负责把.class转成 Dalvik 可执行的.dex而老版本的dx只认到 Java 7 的字节码版本号51.0。你如果装了 JDK 1.8编译出来的 class 文件版本号是 52.0dx 会直接甩给你一句trouble processing: javac: invalid target release dx unsupported class file version 52.0这个报错在搜索里非常高频解决办法有三个我按推荐程度排把工程的 Java 编译器级别降到 1.6 或 1.7推荐改动最小全局把 Eclipse 的编译器级别降下来装 JDK 1.7 并把 Eclipse 指向它第一种做法的操作路径是右键工程 → Properties → Java Compiler → 取消勾选Enable project specific settings的自动继承把Compiler compliance level改成 1.7。改完记得 Clean 一下工程否则旧 class 还会残留。注意只改工程级别有时候不够因为 Eclipse 全局的 JDK 还是 1.8编译器可能仍然按 1.8 的 API 给你检查代码。稳妥做法是全局和工程两级都设成 1.7再确认Window → Preferences → Java → Installed JREs里指向的是 1.7。2.2 新建 Android 工程时的关键参数怎么定Eclipse 里新建工程是File → New → Android Application Project这一步有四个参数必须想清楚Minimum Required SDK最低支持的版本决定了你用不了哪些新 API。博学谷这种教学项目我设API 14Android 4.0覆盖率足够高而且 Fragment、ActionBar 这些基础组件都能用。Target SDK你测试和适配的目标版本设成API 19Android 4.4。这个值影响系统的兼容行为比如 targetSdk 19 以上的机器不会给你默认加溢出的菜单键。Compile With编译时用哪个版本的 SDK设API 19。这个值决定了你能调用哪些 API和 target SDK 可以不一样但新手建议保持一致少一层心智负担。Theme这里选None或者Holo Light。为什么不选带 ActionBar 的主题因为欢迎界面是满屏的顶部多一条 ActionBar 会把背景图挤下去你还得在代码里requestWindowFeature去隐藏它不如一开始就选个干净的主题在styles.xml里自己定义。包名我一般用com.boxuegu.app这种反向域名格式。注意包名一旦定下来后面改起来很麻烦因为R.java的包路径、AndroidManifest里的package属性、跳转时的Intent组件名都要跟着改。定之前多想三秒。创建向导里还会问你「Create Activity」和「Create custom launcher icon」我的做法是把这两个都勾上让它生成一个MainActivity和一套默认图标然后把MainActivity先清空成只留onCreate和setContentView的空壳等欢迎页做完再回来填内容。2.3 project.properties 与编译目标的一致性检查Eclipse 工程的编译目标写在project.properties里内容是这么一行targetandroid-19这个数字必须和你AndroidManifest.xml里的targetSdkVersion对上也和你在Compile With里选的一致。三个地方不一致会出现两种典型症状要么是R.java不生成整个项目一片红要么是某些 API 明明存在却提示找不到符号。我遇到过一次排查了四十分钟最后发现是project.properties里还写着android-14而我代码里用了一个 API 19 才有的方法。顺手把AndroidManifest.xml的基础骨架也定下来欢迎页的注册要在这里写?xml version1.0 encodingutf-8? manifest xmlns:androidhttp://schemas.android.com/apk/res/android packagecom.boxuegu.app android:versionCode1 android:versionName1.0.0 uses-sdk android:minSdkVersion14 android:targetSdkVersion19 / application android:allowBackuptrue android:icondrawable/ic_launcher android:labelstring/app_name android:themestyle/AppBaseTheme activity android:name.SplashActivity android:themestyle/SplashTheme android:screenOrientationportrait intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity activity android:name.MainActivity android:screenOrientationportrait / /application /manifest有两个细节值得说。第一android:screenOrientationportrait把欢迎页锁成竖屏否则用户在横屏状态下打开 App你的背景图会被拉伸得很难看。第二SplashTheme这个主题我们单独定义它的作用不是好看而是解决冷启动白屏后面第 3.5 节会详细讲。3. 欢迎界面从布局到跳转的完整实现3.1 布局文件怎么排版才不会变形欢迎页的布局看着简单其实是个适配重灾区。我用的是RelativeLayout打底因为它的「相对定位」特性让底部对齐、居中对齐变得很直观不需要嵌套多层LinearLayout去凑位置。嵌套层数多了绘制性能会掉虽然欢迎页只有一屏无所谓但习惯要养好。?xml version1.0 encodingutf-8? RelativeLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:backgrounddrawable/bg_splash ImageView android:idid/iv_logo android:layout_widthwrap_content android:layout_heightwrap_content android:layout_centerInParenttrue android:srcdrawable/ic_logo_boxuegu android:contentDescriptionstring/app_name / TextView android:idid/tv_slogan android:layout_widthwrap_content android:layout_heightwrap_content android:layout_belowid/iv_logo android:layout_centerHorizontaltrue android:layout_marginTop16dp android:textstring/slogan android:textColor#FFFFFF android:textSize14sp / TextView android:idid/tv_version android:layout_widthwrap_content android:layout_heightwrap_content android:layout_alignParentBottomtrue android:layout_centerHorizontaltrue android:layout_marginBottom24dp android:textstring/version_placeholder android:textColor#99FFFFFF android:textSize12sp / /RelativeLayout几个用单位的细节这是新手最容易搞混的地方layout_marginTop16dp用 dp因为它描述的是物理尺寸textSize14sp用 sp因为它要跟随用户在系统设置里调的字号textColor#99FFFFFF里前两位是透明度99大概是 60% 不透明这样版本号会显得比主文案弱一点视觉层次就出来了。contentDescription这个属性很多人懒得写但它是给读屏软件用的。不写的话视障用户打开你的 App 只能听到「未标记的图像」体验很差。写一句成本几乎为零值得养成习惯。3.2 背景图适配9-patch 与密度切图的取舍背景图是欢迎页最占资源的东西。如果你直接放一张 1080×1920 的整图在 720P 的机器上系统会去缩放它一来浪费内存二来非等比例压缩可能让 Logo 变形。我在这个项目里用了两种做法的组合方案 A整图背景。适用于设计感强、有复杂渐变的启动图。做法是把图放到drawable-nodpi或者按密度分目录放代码里用scaleTypefitXY配合ImageView。缺点是各分辨率下可能被裁切边角。方案 B纯色背景 独立 Logo。适用于简洁风格。背景用colors.xml里定义的一个色值或者一个 1×1 的极小图做平铺Logo 单独一张图居中。优点是内存占用极小适配任何屏幕比例都不会崩。我最后选的是 B 的变体用一个从上到下的渐变色作为bg_splash.xmlshape drawableLogo 和文字单独叠上去。这样整个欢迎页的资源加起来不到 30KB启动速度飞快。!-- res/drawable/bg_splash.xml -- ?xml version1.0 encodingutf-8? shape xmlns:androidhttp://schemas.android.com/apk/res/android android:shaperectangle gradient android:startColor#2D8CF0 android:endColor#1A6FD4 android:angle270 / /shape如果你确实需要用整图而且图里有需要保护不被拉伸的元素比如边角的花纹那就得做点九图9-patch。做法是在 SDK 目录的tools/draw9patch.bat里打开图片在四边画黑线定义可拉伸区域和内容区域保存成xxx.9.png。点九图的好处是它只拉伸你画黑线的中间部分四个角永远保持原样。这个工具在老版本 SDK 里是自带的新版本可能需要在tools目录下找一下。3.3 SplashActivity 的核心逻辑延时跳转怎么写才不出事这一屏的代码量很小但每行都有讲究。先看我写的第一版它能跑但有隐患// 能跑但别这么写的版本 public class SplashActivity extends Activity { Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_splash); new Handler().postDelayed(new Runnable() { Override public void run() { startActivity(new Intent(SplashActivity.this, MainActivity.class)); finish(); } }, 2000); } }问题在哪Handler持有Activity的隐式引用如果用户在 2 秒内按 Home 键把 App 切到后台然后系统内存紧张把这个 Activity 回收了这个Runnable还在消息队列里排着等到它执行的时候SplashActivity.this已经不在了轻则跳转失效重则抛异常。更糟的是这会造成内存泄漏Activity 对象一直回收不掉。我改成用静态内部类加弱引用的写法public class SplashActivity extends Activity { private static final int DELAY_MILLIS 2000; private static final int MSG_GO_MAIN 1001; private static class SplashHandler extends Handler { private final WeakReferenceSplashActivity ref; SplashHandler(SplashActivity activity) { this.ref new WeakReferenceSplashActivity(activity); } Override public void handleMessage(Message msg) { SplashActivity activity ref.get(); if (activity null || activity.isFinishing()) { return; } if (msg.what MSG_GO_MAIN) { activity.goToMain(); } } } private final SplashHandler handler new SplashHandler(this); Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_splash); initVersionText(); handler.sendEmptyMessageDelayed(MSG_GO_MAIN, DELAY_MILLIS); } private void goToMain() { Intent intent new Intent(this, MainActivity.class); startActivity(intent); finish(); } Override protected void onDestroy() { handler.removeCallbacksAndMessages(null); super.onDestroy(); } }这段代码里有四个我特别想强调的点第一弱引用是必须的。WeakReference让 Handler 不强行拖着 Activity系统该回收就回收ref.get()拿到 null 的时候我们就什么都不做。第二isFinishing()判断不能省。用户可能在 2 秒内手动按了返回或者从最近任务里划掉了 App。这时候 Activity 已经在销毁流程里你还去startActivity会看到闪一下的异常跳转。第三onDestroy里要清消息队列。removeCallbacksAndMessages(null)传 null 表示清掉这个 Handler 的所有待处理消息避免延迟任务在 Activity 死后还执行。第四只调用finish()不要调System.exit()。见过有同学为了让欢迎页彻底消失写了System.exit(0)结果整个进程被杀用户在主页按返回键会看到桌面App 状态全丢。finish()只是把当前 Activity 出栈进程还活着这才是正确姿势。3.4 版本号动态读取与容错处理硬编码版本号是新手最常见的偷懒做法问题是你每次发版都要手动改一次strings.xml早晚有一天会忘。正确做法是运行时从PackageManager里读。private void initVersionText() { TextView tvVersion (TextView) findViewById(R.id.tv_version); tvVersion.setText(getString(R.string.version_prefix) getVersionName()); } private String getVersionName() { try { PackageInfo info getPackageManager() .getPackageInfo(getPackageName(), 0); return info.versionName; } catch (PackageManager.NameNotFoundException e) { e.printStackTrace(); return 未知版本; } }getPackageInfo的第二个参数是 flag传 0 表示只要基础信息如果你要拿签名信息得传PackageManager.GET_SIGNATURES那样会更耗资源。这里只要版本名0 就够了。NameNotFoundException这个异常看起来永远不会发生——包名不就是自己的包名吗怎么会找不到实际上在某些定制系统上多用户切换、应用被部分卸载的中间态确实会抛这个异常。加上 try-catch 只是三行代码但能避免线上因为一个字符串显示的崩溃这笔买卖划算。兜底文案我用「未知版本」比「」或者「null」体面多了。配套的字符串资源!-- res/values/strings.xml -- resources string nameapp_name博学谷/string string nameslogan让学习成为一种习惯/string string nameversion_prefix版本 V/string string nameversion_placeholder版本 V/string /resources3.5 冷启动白屏的成因与主题解法这个点我觉得是整个欢迎页最有技术含量的一块。你会发现即使你把布局写得再好App 启动的时候还是会先闪一下白色或者黑色然后才出现你的背景图。这个「闪」到底是什么它是系统在你 Activity 的onCreate执行之前根据AndroidManifest里配的主题先给你画一个预览窗口Preview Window内容就是主题里的windowBackground。默认主题的windowBackground是白色或黑色所以你就看到了白闪或黑闪。解法思路很直接把这个预览窗口的背景色改成和你欢迎页一致的颜色用户就感觉不到闪烁了。!-- res/values/styles.xml -- resources style nameSplashTheme parentandroid:style/Theme.Light.NoTitleBar item nameandroid:windowBackgrounddrawable/bg_splash/item /style /resources然后在AndroidManifest里把SplashActivity的 theme 指向SplashTheme。注意这个主题和 Application 级别的AppBaseTheme是分开的AppBaseTheme供其他页面用SplashTheme只给欢迎页用。这样一来系统的预览窗口直接显示你的渐变背景等onCreate跑完绘制真正的布局两者视觉上完全接上白屏就消失了。提示如果你用的是整图背景windowBackground直接指向那张图。但要注意预览窗口的绘制是拉伸铺满的如果你的图比例和屏幕不一致会被拉伸变形。这时候就体现前面 3.2 节选渐变背景的优势了——渐变色怎么拉伸都好看。还有一个进阶技巧如果欢迎页的跳转逻辑很轻不依赖网络请求可以在onCreate里做「无必要不做耗时操作」的处理让首帧尽快出来。检查一下你的SplashActivity里有没有偷偷做数据库初始化、SharedPreferences 大量读写、或者网络探测。这些都应该挪到跳转之后或者用异步线程做。我见过一个项目在欢迎页里同步读取了 20 个本地配置文件冷启动硬生生拖到 4 秒用户反馈全在骂卡。3.6 返回键屏蔽与跳转目标的预留设计欢迎页按返回键退出 App这个行为在很多产品里是刻意的减少一次操作但在教学类 App 里通常要屏蔽避免用户误触退出。做法是重写onKeyDown或者onBackPressedOverride public void onBackPressed() { // 欢迎页不响应返回键什么都不做 }onBackPressed()是 API 5 之后的标准入口比onKeyDown判断 keyCode 要干净。这里留空就是屏蔽。要注意的是从 Android 2.0 开始系统对onBackPressed的处理就有默认实现finish 当前页你重写后不调super就覆盖掉了默认行为。至于跳转目标我在goToMain()里留了一个钩子方便后面「二」的引导页接进来private void goToMain() { Intent intent; if (isFirstLaunch()) { // 首次启动走引导页二期功能 intent new Intent(this, MainActivity.class); } else { intent new Intent(this, MainActivity.class); } startActivity(intent); finish(); } private boolean isFirstLaunch() { SharedPreferences sp getSharedPreferences(app_config, MODE_PRIVATE); return sp.getBoolean(first_launch, true); }isFirstLaunch用SharedPreferences存一个布尔标记首次为 true引导页走完后置为 false。这个模式很通用升级弹窗、新手教程、权限引导都可以套。注意MODE_PRIVATE是唯一该用的模式其他几个模式MODE_WORLD_READABLE、MODE_WORLD_WRITEABLE在新版本已经被废弃了用了不仅没意义还可能有安全问题。4. 高频报错与排查技巧实录4.1 编译期dx 报 unsupported class file version 52.0这个报错前面 2.1 节提过原因这里补充完整的排查路径。这类报错看着吓人其实排查就三步第一步确认 Eclipse 工程级别的 Java 编译器是不是 1.7 或更低。右键工程 → Properties → Java Compiler看Compiler compliance level那一栏。如果显示 1.8改成 1.7。第二步确认全局偏好设置。Window → Preferences → Java → Compiler同样改成 1.7。这一步经常被漏掉因为工程级别设了之后按理说就够了但某些 Eclipse 版本会以全局设置覆盖。第三步确认Installed JREs指向的 JDK 版本。如果全局只有 JDK 1.8即使编译器级别设成 1.7Eclipse 也可能用 1.8 的javac加-source 1.7 -target 1.7理论上没问题但某些场景下bootclasspath还是会带进 1.8 的类库导致版本号不对。三步做完还报错就在工程上右键 → Clean把bin目录清掉重新编译。残留的旧 class 文件是这类问题的常见元凶。4.2 运行期欢迎页一闪而过或卡死不跳「一闪而过」通常是两件事要么finish()被过早调用要么跳转目标 Activity 自己也崩了导致你看到的是崩溃后的画面。排查顺序是先看 Logcat 有没有异常堆栈。Eclipse 的 Logcat 视图默认会过滤得太狠建议按包名加个 filter在 Logcat 面板点绿色加号Filter Name 随便填by Package Name 填com.boxuegu.app这样只显示你自己的日志一堆系统噪音会消失。「卡死不跳」最常见的原因是Handler的消息没发出去或者被提前清了。检查一下有没有在别的地方调了removeCallbacksAndMessages以及sendEmptyMessageDelayed的耗时参数是不是写成了一个特别大的数比如把 2000 毫秒写成了 2000000。还有一个隐蔽情况在部分定制系统上如果你的 App 被省电策略冻结Handler的延迟消息会停止计时用户切回来的时候才发现还停在欢迎页。这种情况没法完全避免但可以在onResume里加个时间戳兜底记录进入页面的时间onResume时如果已经超过预定时长就直接跳转。4.3 跳转崩溃ActivityNotFoundException 的四种成因这个异常的信息很明确它会告诉你系统找不到哪个组件。按我的经验成因就这四种成因表现解决办法Manifest 未注册目标 Activity找不到组件包名对得上在 Manifest 里补activity节点包名前缀不一致日志里显示的名字和你的类对不上检查Intent里的类全路径类放在默认包或包名写错编译能过运行时找不到确认src下目录结构和 package 声明一致Activity 被外部 App 隐式启动但未配 exported只有跨应用启动时才出现隐式跳转需配android:exportedtrue最容易忽略的是第二种。Eclipse 里改了包名之后AndroidManifest的package属性、src下的目录层级、每个 java 文件顶部的package声明三处都得同步改。少改一处编译期可能不报错因为gen目录下的R.java会按 Manifest 的包名生成但运行时Intent里的类路径就错了。4.4 调试期真机连不上 adb 的排查清单Eclipse 里跑真机最烦的就是设备列表空的。按这个顺序查# 第一步确认 adb 认识设备 adb devices # 如果有设备但显示 unauthorized需要在手机上点允许调试 # 如果列表是空的往下走 # 第二步重启 adb 服务 adb kill-server adb start-server # 第三步检查 5037 端口有没有被别的进程占了 netstat -ano | findstr 5037如果 5037 被占用常见于同时装了其他手机助手类软件你需要找到占用进程结束掉或者把ADB_SERVER_PORT环境变量改成别的值。另外Windows 上装第三方手机助手会自带一份 adb版本和 SDK 里的不一致时也会互相打架建议只保留 SDK 目录下platform-tools里的那一份把环境变量 PATH 指向它。还有一个高频坑手机连上后adb devices能看到设备但 Eclipse 的 Devices 视图里没有。这种情况一般是 adb 连接是给命令行用的Eclipse 需要重新识别。做法是在 Devices 视图里点Reset adb或者干脆重启 Eclipse。4.5 排查速查表把上面这些整理成一张表出问题的时候对着查症状最可能的原因快速验证方式R.java 不生成满屏红资源文件有语法错误或 target 版本不一致看 Problems 视图第一条报错dx unsupported class file version编译器级别高于 1.7检查 Project Properties → Java Compiler启动白屏一闪主题的 windowBackground 是默认色检查 SplashActivity 的 theme跳转后立刻闪退目标 Activity 自己的 onCreate 崩了看 Logcat 完整堆栈别只看最后一行背景图变形缺对应密度的切图被系统拉伸检查 drawable-*dpi 目录是否齐全版本号显示为空硬编码了空串或 PackageManager 抛异常加日志打印 versionName 的返回值真机不识别adb 服务冲突或驱动缺失adb devices看是否有输出5. 从欢迎界面能延伸出去的几件事5.1 引导页与欢迎页的分工欢迎页和引导页经常被混为一谈但它们的职责完全不同。欢迎页是「每次都要看」引导页是「第一次才看」。所以正确的流程是启动 → 判断是否首次 → 首次走引导页 → 引导页结束进主页 → 同时把标记置 false。非首次则从欢迎页直接进主页。引导页用ViewPager实现最省事三到四屏滑动最后一屏放「立即体验」按钮。这里有个细节引导页的每一屏都应该能被跳过右上角放一个「跳过」文字按钮。用户第二次装你的 App比如换手机重装时强制看完四屏引导会让人很烦躁。从代码结构上看SplashActivity里的isFirstLaunch()那个分支就是给引导页预留的位置。二期做引导页的时候只需要改一行Intent的目标类其他逻辑不用动。这就是为什么我一直建议分支先留出来——成本极低收益是你后面改需求时不用重构。5.2 启动广告位与倒计时跳过商业项目里欢迎页上加一个启动广告是很常见的变现手段。做法是在欢迎页上叠一个ImageView显示广告图右上角放一个圆角的倒计时按钮「3s 跳过」。倒计时用CountDownTimer实现比Handler每秒钟发一次消息要清爽。但这里有几个坑必须提醒。第一广告图的加载是网络请求如果纯同步等图片下载完再显示用户可能盯着白屏四五秒得不偿失。正确做法是先显示本地默认启动图广告图异步加载加载成功了再淡入替换。第二广告位的点击跳转要用try-catch包住因为广告主配的落地页链接可能失效跳转失败不能连带把 App 崩了。第三也是最容易被忽略的用户从广告点进去返回时的行为要理清楚——是回到欢迎页还是回到主页我的做法是点广告的时候就把欢迎页finish掉先跳主页再把广告页压在主页面之上这样返回行为最符合直觉。5.3 老 Eclipse 工程迁移到 Android Studio 的注意点如果你接手了这个 Eclipse 工程早晚有一天要考虑迁移。迁移本身不算难File → New → Import Project选 Eclipse 工程目录Android Studio 会自动生成build.gradle并把目录结构改成 Gradle 风格。迁移途中有几个点要特别小心。第一libs目录下的 jar 不会自动转成 Maven 依赖需要你手动改成compile files(libs/xxx.jar)或者换成对应的 Maven 坐标后者更好因为能享受版本升级。第二AndroidManifest.xml里的package属性在 Gradle 里由applicationId接管package属性会被忽略如果你原来的包名和applicationId不一致比如多渠道打包改过迁移后会出问题要检查build.gradle里的applicationId是不是你想要的。第三Eclipse 里那些values-v11、values-v14的分版本目录Gradle 也支持但要注意compileSdkVersion别设太低否则这些目录全部不生效。迁移完成后把欢迎页跑一遍重点验证三件事主题的windowBackground有没有生效、版本号读取正不正常、跳转逻辑有没有丢。这三件事验证通过基本就说明迁移没伤到核心逻辑。最后分享一点我自己的体会。欢迎界面这个需求几乎所有 Android 教程的第一课都会讲但大部分教程只教你「怎么写一个能跳转的页面」不告诉你「为什么要屏蔽返回键」「为什么白屏要改主题」「为什么 Handler 要用弱引用」。而这些恰恰是区分「能跑」和「敢上线」的分水岭。我的习惯是每做一个看起来简单的页面都多问自己一遍如果用户在 0.5 秒内做了一个我没想到的操作这个页面会怎么样把这个问题想清楚你的代码质量会上一个台阶。