Android 入门精要：Java 移动开发从环境搭建到网络请求实战

简介《Android编程入门精要》是一份面向零基础移动开发学习者的PDF电子书资源围绕Java核心语法、Android Studio开发环境、UI界面设计、数据存储与高级组件实战展开帮助初学者从零构建完整App。全书以项目驱动方式讲解字符串资源、命名规范、ListView、Fragment及数据库操作等关键技术适合希望系统入门Android开发、逐步向工程师进阶的读者。资源包内共1个PDF文件压缩包大小约17.5MB内容完整、便于离线阅读与随时查阅。目前已有57人学习浏览可作为移动开发入门阶段的参考读物。通过阅读读者能够掌握开发环境搭建、界面布局与用户体验设计思路理解ListView列表展示与Fragment管理复杂界面的用法并学会在应用中安全高效地完成数据持久化与数据库操作为后续进阶打下扎实基础。1. 从一份 Android 入门精要拆起Java 移动开发到底该先啃哪几块刚入行那会儿我拿到一份标着「Android 编程入门精要」的资料包第一反应是——又是那种从 Activity 生命周期讲到四大组件、最后停在「Hello World」的流水账。但翻完之后发现不太一样它把 Java 移动开发这条线拆得比较清楚从环境搭建、UI 布局、事件处理到数据存储和网络请求基本覆盖了一个新手从零到能跑通一个完整小应用所需的全部环节。如果你正在找一份能照着敲、敲完能跑、跑完能理解「为什么这么写」的 Android 入门材料这份东西值得花时间过一遍。它适合两类人一是刚学完 Java 基础、想找个落点把语法用起来的二是做过一点前端或后端、想快速摸清 Android 开发套路的。不适合指望看完就能上手商业项目的人——入门精要解决的是「能写」不是「写好」。2. 环境搭建与第一个可运行工程别在第一步就翻车2.1 工具链选型为什么是 Android Studio 而不是 Eclipse现在网上还能搜到一些用 Eclipse ADT 插件搭 Android 环境的教程我的建议是直接跳过。Android Studio 从 2014 年成为官方 IDE 之后Gradle 构建、布局预览、Lint 检查、模拟器管理这些环节已经整合得比较顺了。入门精要里默认也是 Android Studio这一点跟当前主流一致。装之前先确认 JDK 版本。Android Studio 自带 JBRJetBrains Runtime但 Gradle 构建时用的 JDK 需要单独配。我一般会在File → Project Structure → SDK Location里把 Gradle JDK 设成 17这是目前 AGP 8.x 的推荐版本。如果 JDK 版本不对最常见的报错是Unsupported class file major version看到这个直接去查 AGP 和 JDK 的对应表就行。SDK 方面入门阶段只需要装一个 API Level 的 Platform 和一个对应的 Build-Tools。不用一上来把所有版本都勾上几十个 G 下下来大概率用不到。模拟器镜像选 x86_64 的ARM 镜像在 Intel 机器上跑起来会卡到怀疑人生。2.2 创建工程时的四个关键选项新建工程界面有几个选项容易让人犹豫我按自己的习惯说一下选项推荐值理由LanguageJava入门精要以 Java 为主线Kotlin 可以后面再切Minimum SDKAPI 24覆盖率高且能避开大部分旧版本兼容坑Build configuration languageGroovy DSL入门阶段 Groovy 的教程和报错信息更多View Binding勾上比 findViewById 省事比 DataBinding 轻创建完之后先别急着写代码点一下运行按钮确认空工程能在模拟器或真机上跑起来。这一步看着多余但能帮你排除掉环境层面的问题——我见过太多人写完第一个界面才发现是 Gradle 同步失败导致的。2.3 目录结构速览哪些文件你真正需要关心一个标准 Android 工程的文件很多但入门阶段真正要动的就几个app/src/main/java/com/example/myapp/ MainActivity.java # 主 Activity入口 app/src/main/res/layout/ activity_main.xml # 主界面布局 app/src/main/res/values/ strings.xml # 字符串资源 colors.xml # 颜色资源 app/build.gradle # 模块级构建配置AndroidManifest.xml也需要了解但入门阶段主要用它注册 Activity 和声明权限。build.gradle里重点关注compileSdk、minSdk、targetSdk三个值以及dependencies块里加的库。提示每次改完build.gradle记得点 Sync Now不然代码里引用新库会标红。2.4 跑通第一个交互按钮点击改文本入门精要里第一个动手环节是做一个按钮点击后改变文本的小例子。这个例子虽小但把布局、资源引用、事件监听三件事串起来了。我把它整理成可直接抄的版本// MainActivity.java package com.example.myapp; import android.os.Bundle; import android.widget.Button; import android.widget.TextView; import androidx.appcompat.app.AppCompatActivity; public class MainActivity extends AppCompatActivity { private TextView tvDisplay; private int clickCount 0; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tvDisplay findViewById(R.id.tv_display); Button btnClick findViewById(R.id.btn_click); // 每次点击更新计数并刷新文本 btnClick.setOnClickListener(v - { clickCount; tvDisplay.setText(点击次数 clickCount); }); } }!-- activity_main.xml -- ?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical android:gravitycenter android:padding24dp TextView android:idid/tv_display android:layout_widthwrap_content android:layout_heightwrap_content android:text点击次数0 android:textSize20sp / Button android:idid/btn_click android:layout_widthwrap_content android:layout_heightwrap_content android:layout_marginTop16dp android:text点我 / /LinearLayout逻辑说明onCreate里先setContentView绑定布局再通过findViewById拿到控件引用。setOnClickListener用的是 lambda 写法比匿名内部类简洁。clickCount是 Activity 的成员变量所以能跨点击事件累加。参数说明layout_width和layout_height的match_parent表示撑满父容器wrap_content表示包裹内容。textSize用sp单位这是 Android 推荐的字号单位能跟随系统字体设置缩放。padding和layout_marginTop的区别是前者在控件内部留白后者在控件外部留间距。跑通这个例子之后你对 Android 工程的运转方式就有了基本感知。后面再学 Activity 生命周期、Intent 跳转、列表展示都是在這個骨架上加东西。3. 四大组件与 Java 代码组织把零散知识串成线3.1 Activity 生命周期不是背方法名而是理解状态迁移入门精要里讲 Activity 生命周期的方式是先画状态图再逐个方法解释但我觉得更有效的方式是先想清楚一个问题用户切到别的应用再切回来你的界面数据还在不在public class MainActivity extends AppCompatActivity { private static final String KEY_COUNT key_count; private int clickCount 0; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 恢复保存的状态 if (savedInstanceState ! null) { clickCount savedInstanceState.getInt(KEY_COUNT, 0); } // ... 初始化控件 } Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); // 保存计数防止被系统回收后丢失 outState.putInt(KEY_COUNT, clickCount); } Override protected void onDestroy() { super.onDestroy(); // 释放资源比如取消网络请求、注销广播 } }onCreate做初始化onSaveInstanceState在 Activity 可能被销毁前保存临时数据onDestroy做清理。这三个方法覆盖了入门阶段 80% 的场景。onResume和onPause更多用在控制传感器、动画、视频播放这类需要随界面可见性启停的逻辑上。3.2 Intent 跳转与数据传递显式与隐式的选择Activity 之间跳转靠 Intent。入门精要里把显式 Intent 和隐式 Intent 分开讲这个分法是对的因为两者的使用场景和坑完全不同。// 显式 Intent明确指定目标 Activity Intent intent new Intent(MainActivity.this, DetailActivity.class); intent.putExtra(item_id, 1001); intent.putExtra(item_name, 示例条目); startActivity(intent); // 在 DetailActivity 中接收 int itemId getIntent().getIntExtra(item_id, -1); String itemName getIntent().getStringExtra(item_name);显式 Intent 用于应用内部跳转安全可控。隐式 Intent 用于调用系统或其他应用的能力比如打开浏览器、拨号、分享。隐式 Intent 的坑在于如果设备上没有能响应该 Intent 的应用startActivity会抛ActivityNotFoundException。所以调之前最好先判断一下Intent browserIntent new Intent(Intent.ACTION_VIEW, Uri.parse(https://example.com)); if (browserIntent.resolveActivity(getPackageManager()) ! null) { startActivity(browserIntent); } else { Toast.makeText(this, 没有可用的浏览器, Toast.LENGTH_SHORT).show(); }3.3 RecyclerView 列表从 Adapter 到 ViewHolder 的最小实现列表展示是移动开发里最高频的需求之一。入门精要里用的是 RecyclerView这是目前的标准做法。它的核心是三个部分Adapter、ViewHolder、LayoutManager。public class SimpleAdapter extends RecyclerView.AdapterSimpleAdapter.VH { private final ListString data; public SimpleAdapter(ListString data) { this.data data; } // 创建 ViewHolder加载 item 布局 NonNull Override public VH onCreateViewHolder(NonNull ViewGroup parent, int viewType) { View view LayoutInflater.from(parent.getContext()) .inflate(R.layout.item_simple, parent, false); return new VH(view); } // 绑定数据到 ViewHolder Override public void onBindViewHolder(NonNull VH holder, int position) { holder.tvItem.setText(data.get(position)); } Override public int getItemCount() { return data.size(); } static class VH extends RecyclerView.ViewHolder { TextView tvItem; VH(NonNull View itemView) { super(itemView); tvItem itemView.findViewById(R.id.tv_item); } } }在 Activity 里设置RecyclerView recyclerView findViewById(R.id.recycler_view); recyclerView.setLayoutManager(new LinearLayoutManager(this)); recyclerView.setAdapter(new SimpleAdapter(dataList));LayoutManager决定排列方向LinearLayoutManager是纵向列表换成GridLayoutManager就是网格。Adapter负责把数据映射到视图上。ViewHolder的作用是缓存控件引用避免每次绑定都重新findViewById——这是 RecyclerView 比老版 ListView 性能好的关键原因之一。3.4 数据存储三件套SharedPreferences、文件、SQLite入门精要里把数据存储分成轻量级和结构化两类。轻量级用 SharedPreferences 存键值对结构化用 SQLite 存表数据。文件存储介于两者之间适合存文本或二进制流。// SharedPreferences 存配置 SharedPreferences prefs getSharedPreferences(app_config, MODE_PRIVATE); prefs.edit() .putString(username, test_user) .putInt(login_count, 5) .apply(); // apply 异步提交commit 同步提交 // 读取 String username prefs.getString(username, ); int count prefs.getInt(login_count, 0);SharedPreferences 的坑在于apply()是异步写内存再落盘commit()是同步写。在主线程里用commit()可能造成卡顿所以一般用apply()。但如果写入后立刻要读apply()还没落盘可能导致读到旧值——这种场景才用commit()。SQLite 部分入门精要里用的是SQLiteOpenHelper建库建表在onCreate里做版本升级在onUpgrade里做。这个模式虽然现在有 Room 这样的 ORM 库可以替代但理解原生 SQLite 的操作对排查问题有帮助。4. 网络请求与异步处理新手最容易踩坑的地方4.1 为什么不能在主线程发网络请求Android 的主线程负责 UI 渲染和事件分发任何耗时操作放在主线程都会导致界面卡顿甚至 ANRApplication Not Responding。网络请求的耗时不可控所以必须放到子线程。入门精要里强调了这一点但很多新手还是会写出在主线程直接调网络库的代码——因为有些网络库内部做了线程切换让人误以为可以随便调。我的习惯是不管用什么库先确认它的回调在哪个线程。如果回调在主线程那可以直接更新 UI如果在子线程就得用runOnUiThread或Handler切回来。4.2 用 HttpURLConnection 理解请求本质入门精要里先用HttpURLConnection讲了一遍原生请求流程这个安排我觉得合理——虽然实际开发中很少直接用但理解了它再用 OkHttp 或 Retrofit 就知道底层在干什么。// 在子线程中执行 new Thread(() - { HttpURLConnection conn null; try { URL url new URL(https://api.example.com/data); conn (HttpURLConnection) url.openConnection(); conn.setRequestMethod(GET); conn.setConnectTimeout(5000); // 连接超时 5 秒 conn.setReadTimeout(5000); // 读取超时 5 秒 int responseCode conn.getResponseCode(); if (responseCode 200) { InputStream is conn.getInputStream(); String result readStream(is); // 自定义读取方法 runOnUiThread(() - tvDisplay.setText(result)); } } catch (IOException e) { e.printStackTrace(); } finally { if (conn ! null) conn.disconnect(); } }).start();setConnectTimeout和setReadTimeout必须设否则网络异常时线程会一直挂着。runOnUiThread把结果切回主线程更新 UI。finally里断开连接释放资源。4.3 OkHttp Retrofit 的入门用法实际项目里更常见的是 OkHttp 做底层请求、Retrofit 做接口封装。入门精要里给了一个最小示例// 定义接口 public interface ApiService { GET(data) CallResponseBody getData(); } // 创建 Retrofit 实例 Retrofit retrofit new Retrofit.Builder() .baseUrl(https://api.example.com/) .addConverterFactory(GsonConverterFactory.create()) .build(); ApiService service retrofit.create(ApiService.class); service.getData().enqueue(new CallbackResponseBody() { Override public void onResponse(CallResponseBody call, ResponseResponseBody response) { // 回调在主线程可直接更新 UI } Override public void onFailure(CallResponseBody call, Throwable t) { // 处理失败 } });Retrofit 的enqueue方法内部已经做了线程切换onResponse和onFailure都在主线程回调。这是它比裸用 OkHttp 方便的地方。但要注意baseUrl必须以/结尾接口路径不能以/开头否则拼接出来的 URL 会出问题——这个坑我踩过不止一次。4.4 权限声明与运行时请求网络请求需要在AndroidManifest.xml里声明INTERNET权限uses-permission android:nameandroid.permission.INTERNET /这个权限是普通权限安装时自动授予不需要运行时请求。但如果是读取存储、定位、相机这类危险权限就需要在代码里动态申请。入门精要里给了一个通用的权限请求模板核心是ActivityCompat.requestPermissions和onRequestPermissionsResult回调。注意Android 6.0 之后危险权限必须运行时申请只在 Manifest 里声明是不够的。5. 避坑与排查那些入门精要不会明说但一定会遇到的事5.1 现象应用启动就闪退Logcat 里一堆红字原因最常见的是布局文件里引用了不存在的资源 ID或者 Activity 没有在 Manifest 里注册。另一个高频原因是findViewById返回 null 后直接调用了方法。解决先看 Logcat 里第一条Caused by那才是根因。如果是NullPointerException检查对应控件的 ID 是否拼写一致。如果是ActivityNotFoundException去 Manifest 里补注册。5.2 现象Gradle 同步失败提示找不到依赖原因网络问题导致依赖下载不下来或者仓库地址配错了。国内访问 Google 的 Maven 仓库有时不稳定。解决在settings.gradle里确认google()和mavenCentral()都在仓库列表里。如果某个依赖一直下不下来可以换一个版本号试试。另外Android Studio 的 Gradle JDK 设置不对也会导致同步失败回到SDK Location里检查。5.3 现象模拟器启动后黑屏或卡死原因模拟器镜像和主机 CPU 架构不匹配或者分配给模拟器的内存太小。解决在 AVD Manager 里编辑模拟器配置把 Graphics 改成Software或Hardware试试内存调到 2048MB 以上。如果主机是 AMD 处理器确认开启了虚拟化支持。5.4 现象RecyclerView 显示空白但数据源明明有数据原因忘记设置LayoutManager或者 Adapter 的getItemCount返回了 0或者 item 布局的根容器高度设成了wrap_content但内部没有内容撑开。解决先确认setLayoutManager调了没有再在getItemCount里打个日志看返回值。item 布局的根容器高度建议用wrap_content宽度用match_parent。5.5 现象网络请求在模拟器上正常真机上失败原因真机和模拟器的网络环境不同或者真机上的应用没有网络权限。解决先确认 Manifest 里声明了INTERNET权限。如果用的是 HTTP 而非 HTTPSAndroid 9.0 之后默认禁止明文流量需要在AndroidManifest.xml的application标签里加android:usesCleartextTraffictrue或者配置network_security_config。这个坑在入门阶段特别常见因为很多教程用的测试接口还是 HTTP 的。6. 从能跑到好用三个让代码质量上一个台阶的习惯6.1 用 View Binding 替代 findViewById入门精要里用的是findViewById这没问题但一旦界面控件多起来满屏的findViewById既啰嗦又容易出错。View Binding 是官方推荐的替代方案在build.gradle里开启之后每个布局文件会自动生成一个绑定类// build.gradle (Module) android { buildFeatures { viewBinding true } }// Activity 中使用 ActivityMainBinding binding ActivityMainBinding.inflate(getLayoutInflater()); setContentView(binding.getRoot()); binding.tvDisplay.setText(直接通过绑定类访问); binding.btnClick.setOnClickListener(v - { /* ... */ });绑定类的名字由布局文件名转换而来activity_main.xml对应ActivityMainBinding。它比findViewById安全的地方在于编译期就能发现 ID 拼写错误而不是等到运行时才崩。6.2 把网络请求封装成 Repository 层入门阶段容易把网络请求、数据解析、UI 更新全写在 Activity 里。一旦页面多了同样的请求逻辑要复制好几遍。我的习惯是抽一个 Repository 层public class DataRepository { private final ApiService apiService; public DataRepository() { Retrofit retrofit new Retrofit.Builder() .baseUrl(https://api.example.com/) .addConverterFactory(GsonConverterFactory.create()) .build(); apiService retrofit.create(ApiService.class); } public void fetchData(CallbackResponseBody callback) { apiService.getData().enqueue(callback); } }Activity 只负责调repository.fetchData(...)和更新 UI不关心数据从哪来、怎么解析。这样后面要加缓存、换数据源都只改 Repository 层。6.3 用 Logcat 过滤和断点配合排查Logcat 的信息量很大不会过滤等于大海捞针。我一般会按包名过滤只看自己应用的日志。另外Log.d的 TAG 用类名方便定位private static final String TAG MainActivity; Log.d(TAG, clickCount clickCount);断点调试和日志不冲突。简单变量值用日志看更快复杂逻辑用断点一步步走。Android Studio 的Evaluate Expression功能可以在断点处直接执行代码查看结果排查问题时很省时间。6.4 一个验证学习效果的小方法学完入门精要之后怎么判断自己真的掌握了我的检验方式是不看任何参考从零创建一个工程做一个包含列表展示、点击跳转详情、详情页从网络加载数据并展示、下拉刷新这四件事的小应用。如果能独立完成说明入门阶段的知识点已经串起来了。如果卡在某个环节回去翻对应章节比从头再看一遍效率高得多。从那以后我每次带新人都会让他们先跑通这个四步小应用再去看更深入的东西。入门精要的价值不在于它讲了多少而在于它给了一条能走通的路。希望帮到你。本文还有配套的精品资源点击获取