简介面向Android物联网应用开发初学者的入门教程资源内含一个名为01_FirstApp的简易工程示例系统覆盖从Android Studio环境搭建、Java语法基础、Activity与Intent通信、XML布局设计、数据存储、网络通信、传感器调用到生命周期管理等核心知识点。压缩包共132个文件其中以XML布局与配置、Java源码、Gradle构建脚本为主体另有properties设置项、PNG图标等辅助资源压缩包整体体积仅945KB便于快速下载和本地对照学习。该资源已有283人学习适合移动物联网方向的学生或自学者在动手实践中理解Android应用的基本架构与常用API。通过这个可直接用Android Studio导入的工程读者能清晰查看界面布局、Manifest注册、事件监听和网络请求的具体代码并配合教程说明进行调试修改从而将抽象概念落实到第一个物联网应用项目中。1. FirstApp 到底是什么Java 安卓物联网课程里的第一个最小工程很多人第一次翻开《Java 安卓移动物联网开发》教程目录看到的第一个项目就是 01_FirstApp。它简陋得有点不像话界面上只有一行 Hello World没有传感器、没有网络、没有按钮。但正是这个最小工程决定着你后面的路顺不顺——MQTT 连接、数据上报、图表展示全都得安放在这个骨架里。FirstApp 只解决三件事验证 JDK、SDK、Gradle 这套环境是不是真的能跑通看清一个安卓工程由哪些文件组成、启动时先执行哪段代码以及拿到第一个能装进手机的 APK让你后面写的业务逻辑有地方运行和观察。这三件事不解决直接去写联网功能出了问题你根本分不清是环境、工程还是代码的锅。它的目标读者很明确从单片机转过来、想给设备配手机控制端的开发者服务端出身、要补移动端交付能力的工程师以及刚接触安卓、准备走物联网方向的学生。无论哪类人FirstApp 都是绕不开的起跑线。2. 在 Android Studio 里创建 FirstApp环境、版本与 Gradle 第一次同步先把结论放在前面想顺利跑通 FirstApp环境配置比代码本身更值得花时间。我见过太多人卡在第一步不是代码写错而是 JDK 版本和 Gradle 版本打架或者 SDK 平台没下载全。这一章把创建工程前必须确认的版本关系、创建时的关键选项以及第一次同步失败怎么办一次讲清楚。2.1 为什么选 Java 而不是 Kotlin存量 SDK 与学习成本这个系列叫 java 安卓移动物联网开发语言选 Java 不是偶然。物联网场景里设备厂商、模组厂商提供的安卓示例和 SDK绝大多数还是 Java 写的很多老项目、工业平板上的定制系统也以 Java 为主。用 Java 起步对照厂商文档时几乎零翻译成本复制过来的代码能直接编译。Kotlin 虽然已经是主流但它和 Java 完全互通等 Java 基础打牢再切过去代价很小。另外从学习成本看Java 的语法对写过 C/C 的嵌入式工程师更友好。类、接口、继承这些概念在 Java 里表达得更直白线程用 Thread、Runnable网络用回调没有协程那套抽象。Java 的教程和示例代码量也最大遇到问题搜出来的解决方案大多直接可用这对新手起步非常重要。先把手感和套路练出来比一上来追新语法更实际。2.2 创建工程名字、包名、最低版本四个选项怎么填常见做法是直接用 Android Studio 的向导创建。打开 Android Studio选择 New Project再选 Empty Views Activity不同版本可能叫 Empty Activity进入配置页后有四个选项要仔细填工程名填 FirstApp包名默认会跟着工程名变成 com.example.firstapp保持默认即可语言选 Java最低版本 Minimum SDK 建议选 API 24 或 26。选太低要兼容一堆老设备的屏幕适配选太高又会把一部分低端安卓设备挡在门外。创建完成后Android Studio 会生成下面这套工程结构FirstApp/ ├── app/ │ ├── src/main/ │ │ ├── java/com/example/firstapp/ │ │ │ └── MainActivity.java │ │ ├── res/layout/ │ │ │ └── activity_main.xml │ │ └── res/values/ │ │ ├── strings.xml │ │ └── themes.xml │ └── build.gradle ├── build.gradle ├── settings.gradle ├── gradle.properties └── gradle/wrapper/ └── gradle-wrapper.properties这套结构里src/main/java 放 Java 源码res 放界面资源两个 build.gradle 负责构建配置。新手最容易迷糊的是为什么有两个 build.gradle根目录那个管整个工程所有模块app 目录那个只管 app 这个模块。后面加依赖库改的基本都是 app/build.gradle。关于三个 SDK 版本用一张表说清区别版本项含义FirstApp 里怎么填compileSdk编译时用的 API 版本决定你能调用哪些新接口保持模板默认值minSdk最低支持的安卓版本低于它的设备装不了API 24 或 26targetSdk运行时行为兼容目标影响权限和系统行为保持模板默认值compileSdk 和 targetSdk 跟着模板走就行minSdk 是唯一需要自己权衡的选项。另外对于物联网项目包名还有一个实际作用同一块开发板配套的 App 往往有多个版本调试版、演示版、正式版包名相同的话装新版必须先卸载旧版。所以从 FirstApp 开始就养成用有意义的包名习惯后面维护多版本能省很多事。2.3 Gradle 第一次同步版本搭配与常见失败工程创建完Android Studio 会自动做一次 Gradle Sync这一步会把 Gradle 本体、依赖库全部下载到本地。Gradle 用哪个版本由 gradle-wrapper.properties 里的 distributionUrl 决定# gradle/wrapper/gradle-wrapper.properties distributionBaseGRADLE_USER_HOME distributionUrlhttps\://services.gradle.org/distributions/gradle-8.7-bin.zip distributionPathwrapper/dists zipStoreBaseGRADLE_USER_HOME zipStorePathwrapper/dists注意 distributionUrl 里的版本号要和 JDK 匹配。新版 Android Studio 一般自带 JDK 17 或更高对应 Gradle 8.x如果你机器上另装了 JDK 8就会报 Unsupported class file major version 这类错误。最简单的办法不要自己单独装 JDK直接用 Android Studio 内置的 JDK路径在 Settings → Build Tools → Gradle 里能看到。第一次同步慢、甚至失败绝大多数是网络问题。Gradle 要拉取大量依赖网络不稳定时会在下载阶段卡很久。解决办法是把根目录 build.gradle 的 repositories 换成可访问的镜像源或者提前把 Gradle 发行包手动下载好放进 wrapper 指定目录。如果同步失败先看 Build 窗口里的具体报错而不是直接重试报 Unsupported class file major version 就是 JDK 版本问题报 Could not resolve 或 Connection refused 就是网络问题。血的教训不要在同步进行到一半时强行关掉 Android Studio损坏的缓存会让你花更多时间重来。提示第一次同步成功后把整个工程目录备份一份。之后无论把 Gradle 配置改坏还是误删文件都能快速回到可用状态。3. 拆开 FirstAppAndroidManifest、MainActivity 与布局文件的工作方式工程建好后先别急着改代码把三个文件读一遍AndroidManifest.xml、MainActivity.java、activity_main.xml。它们是 FirstApp 能跑起来的全部秘密也是后续所有功能的地基。3.1 App 入口不是 main 函数AndroidManifest 的作用写惯了 Java 控制台程序的人第一次看安卓工程都会懵main 函数在哪安卓没有 main 函数系统启动应用时由包管理器读取 AndroidManifest.xml找到声明为 MAIN LAUNCHER 的 Activity把它作为入口拉起来。这个清单文件就是应用的总指挥。!-- app/src/main/AndroidManifest.xml -- manifest xmlns:androidhttp://schemas.android.com/apk/res/android application android:allowBackuptrue android:iconmipmap/ic_launcher android:labelstring/app_name android:themestyle/Theme.FirstApp activity android:name.MainActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity /application /manifest这段 XML 里android:name.MainActivity 前面的点是包名的简写完整路径是 com.example.firstapp.MainActivity。intent-filter 里 MAIN 表示这是入口LAUNCHER 表示它要出现在桌面启动器里。android:exportedtrue 是安卓 12 之后必须显式声明的属性表示这个 Activity 可以被外部应用启动。对物联网开发来说这个文件后面会频繁改动加网络权限、声明后台服务、注册广播接收器全都在这里。养成习惯每次工程报错找不到类、找不到入口先回这个文件检查。3.2 MainActivity 与生命周期页面在何时生、何时死MainActivity 是整个 App 唯一的 Java 类当前它短得可怜// app/src/main/java/com/example/firstapp/MainActivity.java package com.example.firstapp; import android.os.Bundle; import androidx.appcompat.app.AppCompatActivity; public class MainActivity extends AppCompatActivity { Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 把布局文件加载进来这一步决定了界面上显示什么 setContentView(R.layout.activity_main); } }onCreate 是 Activity 的第一个回调相当于页面出生。setContentView(R.layout.activity_main) 把布局资源解析成真正的界面。savedInstanceState 用来恢复被系统杀掉的页面状态FirstApp 里用不到但要知道它存在。Activity 生命周期除 onCreate 外还有 onStart、onResume、onPause、onStop、onDestroy 五个回调。对物联网 App 来说这套机制比想象中重要手机锁屏时 onStop 被调用你代码里定时上报的 Handler 还跑不跑切到后台要不要断开网络连接这些问题都要靠生命周期回调来管理。记住一个口诀前台可见且可交互时在 onResume完全不可见时在 onStop销毁前在 onDestroy。回调触发时机物联网场景里的用途onCreate页面创建初始化界面、恢复数据onResume页面回到前台可见恢复定时上报onPause页面部分不可见暂停高频刷新onStop页面完全不可见断开不必要的连接onDestroy页面销毁释放资源、反注册回调3.3 布局文件TextView、Button 与 dp 单位activity_main.xml 是界面模板。模板默认是一个 LinearLayout里面放一行 TextView!-- app/src/main/res/layout/activity_main.xml -- LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical TextView android:layout_widthwrap_content android:layout_heightwrap_content android:textHello World! android:textSize18sp / /LinearLayoutlayout_width 和 layout_height 有两个常用取值match_parent 表示填满父容器wrap_content 表示随内容自适应。LinearLayout 的 orientation 决定子控件是横着排还是竖着排。textSize 用 sp 单位因为它会跟随系统字体缩放间距、宽高这类尺寸用 dp不随字体变。新手最容易犯的错是全部用 px换台高分辨率设备界面就乱套。布局和 Java 代码的关联点在于 R 文件。R 是编译时自动生成的资源索引类R.layout.activity_main 对应这个 XML。之后给界面上的控件加事件都要通过 findViewById 或 ViewBinding 拿到控件实例这是后面所有交互代码的入口。新版 Android Studio 默认会开启 ViewBinding它让 findViewById 不再必要但 FirstApp 阶段我建议先手写 findViewById因为它是理解资源索引这个机制的最小路径。等你能解释清楚为什么 R.id 对应一个控件再切换到 ViewBinding 不迟。4. 让 FirstApp 动起来按钮事件、Handler 模拟传感器与网络权限到这里 FirstApp 还只是一个静态页面。物联网 App 的核心动作就三类接收用户操作、定时或被动刷新数据、把数据发给服务器。下面把三件事的最小代码都写出来写完跑一遍FirstApp 就从一个空壳变成了会响应、会定时、能联网的雏形。4.1 给 Button 绑定点击事件从设备侧思维切到事件驱动嵌入式开发通常是 while(1) 循环里不断轮询安卓不一样它是事件驱动的。界面上的按钮被点击系统会回调你注册的监听器。先在布局里加一个按钮Button android:idid/btn_read android:layout_widthwrap_content android:layout_heightwrap_content android:text读取传感器 /id 是控件的唯一标识id/btn_read 表示新建一个叫 btn_read 的 id。然后在 MainActivity 里绑定// 在 onCreate 中setContentView 之后加这段代码 Button btnRead findViewById(R.id.btn_read); btnRead.setOnClickListener(new View.OnClickListener() { Override public void onClick(View v) { Log.d(FirstApp, 按钮被点击); } });记得在文件顶部补上 import android.widget.Button 和 import android.view.View。setOnClickListener 接收一个接口实例onClick 就是回调方法。findViewById 返回的泛型类型足够让编译器直接推断出 Button所以不需要强转。Log.d 的 d 是 debug 级别TAG 用 FirstApp之后在 Logcat 里按 TAG 过滤就能看到自己的日志。4.2 用 Handler 定时刷新数据模拟传感器上报真实物联网项目里App 要周期性显示设备上报的温度、电量。FirstApp 阶段没有真实设备用 Handler 加一个定时任务模拟// 绑定主线程 Looper 的 Handler保证任务运行在 UI 线程 Handler handler new Handler(Looper.getMainLooper()); Runnable sensorTask new Runnable() { Override public void run() { // 模拟读取传感器生成 20~30 度的随机温度 double temp 20.0 Math.random() * 10.0; Log.d(FirstApp, 当前温度: String.format(%.1f, temp) ℃); // 再次把自己投递到消息队列2 秒后继续执行 handler.postDelayed(this, 2000); } }; // 启动定时任务 handler.post(sensorTask);这个写法的关键是 postDelayed(this, 2000)Runnable 执行完把自己再投递回去形成每 2 秒一次的循环。Looper.getMainLooper() 表示任务运行在主线程可以直接更新 UI但主线程不能被耗时操作阻塞否则界面会卡死并弹出 ANR 弹窗。千万不要用 Thread.sleep 写在主线程里定时那会让整个界面冻结。真实项目里网络请求和数据刷新会放到子线程或专门的调度器里做但 FirstApp 阶段理解 Handler 这套消息机制就理解了安卓线程模型的一半。4.3 加网络权限和明文流量开关为 MQTT 和 HTTP 铺路物联网 App 几乎没有不联网的。安卓系统的网络权限需要显式声明在 AndroidManifest.xml 的 manifest 节点下加一行uses-permission android:nameandroid.permission.INTERNET /只加 INTERNET 权限还不够。安卓 9 之后默认禁止 HTTP 明文流量而物联网设备在局域网里跑的往往是 http://192.168.x.x 这种地址不是 HTTPS。开发阶段可以在 application 节点上加 usesCleartextTrafficapplication android:usesCleartextTraffictrue ... 这个开关只建议在调试阶段打开。上了生产环境要么走 HTTPS要么针对特定域名配置网络安全配置文件直接全量放开明文流量会被应用市场审核盯上。到这里FirstApp 已经具备了一个物联网客户端 App 的最小雏形能响应操作、能定时刷新、能访问网络。5. FirstApp 避坑指南新手跑第一个安卓工程的 5 个高频问题这一章是我带人做模拟项目 X 时反复遇到的真实问题以下 5 个坑按出现频率排序每条按现象、原因、解决三步说清楚。这些坑基本上每个人都踩过有的翻车翻得毫无尊严提前看完能帮你省掉不少折腾时间。5.1 模拟器冷启动慢到怀疑人生现象创建完工程点 Run模拟器转了十几分钟才进桌面进入后操作一卡一卡的。原因模拟器没有启用硬件加速或者 AVD 镜像选的 ARM 架构在 x86 电脑上跑 ARM 镜像靠软件模拟慢是必然的。解决创建 AVD 时系统镜像选 x86_64并在 SDK Manager 里确认装好了对应的加速器组件如果笔记本 BIOS 里虚拟化没开先去 BIOS 打开 VT-x。另外一个更省事的办法是直接用真机调试见 5.4。5.2 R 文件集体飘红现象代码里 R.layout.activity_main、R.id.btn_read 全部标红编译报 cannot find symbol。原因资源文件有语法错误导致资源编译失败或者改过资源后没有同步。解决先看 res 目录下 XML 有没有报错没有的话执行 Build → Clean Project再执行 File → Sync Project with Gradle Files。记住顺序先找资源文件本身的错误再谈重新生成 R。把飘红当玄学反复乱点是没有意义的。5.3 改完代码运行还是旧界面现象改了 activity_main.xml 的文案点 Run 装到手机上界面还是旧内容。原因增量编译没有把改动打包进去或者设备上还装着旧 APK新的没覆盖成功。解决优先用 Build → Rebuild Project 做一次全量构建同时在真机或模拟器上先卸载旧应用再运行。养成习惯每次大改布局后 Rebuild 一次能省掉很多我以为改好了的尴尬。5.4 真机连不上 adb现象手机插上 USBadb devices 列表是空的或者显示 unauthorized。原因没开开发者选项和 USB 调试授权弹窗被误点成拒绝数据线只支持充电不支持传输。解决设置里连点版本号 7 次打开开发者选项打开 USB 调试插线后手机上确认 RSA 授权换一根确认能传数据的线还不行就执行 adb kill-server 再 adb start-server。部分深度定制系统还要额外打开仅充电模式下允许 ADB 调试之类的开关。5.5 日志里中文乱码现象Log.d 打出的中文在 Logcat 里显示成乱码英文正常。原因IDE 控制台默认编码和工程编码不一致常见于 Windows 上 GBK 与 UTF-8 混用。解决Settings → Editor → File Encodings 里把 Global Encoding 和 Project Encoding 都设成 UTF-8。日志 TAG 保持英文重要数据内容也尽量用英文或拼音减少编码问题带来的干扰。等后面接真实设备时设备返回的 UTF-8 中文数据也需要统一编码现在养成习惯后面少受罪。6. 从 FirstApp 迈向物联网端四个验证动作与下一步路线FirstApp 跑通只是起点你需要先验证自己真的理解了这套工程再往前推进。6.1 用 adb logcat 验证自己的程序验证动作一看日志。程序跑起来后在终端执行# 列出当前连接的设备 adb devices # 只看 FirstApp 这个 TAG 的日志 adb logcat -s FirstApp能看到按钮点击和温度输出的日志说明事件绑定、Handler 定时器、日志系统三条链路都通了。验证动作二改包名。把包名从 com.example.firstapp 换成你自己的命名全工程同步替换后重新构建装到一台旧安卓手机上能装上能启动说明你对工程结构的理解是对的。验证动作三真机跑一遍模拟器之外的场景把屏幕亮度、电池电量这些真实数据通过 Log 打出来体会真机和模拟器的差异。验证动作四关掉屏幕再打开观察日志里生命周期回调的先后顺序确认 onStop 和 onResume 是否如前面那张表所述。6.2 一个自检清单与下一步路线验证点检查位置期望结果环境链路新建工程能跑模拟器或真机出现 Hello World事件链路点击按钮Logcat 出现按钮点击日志定时链路观察 10 秒温度日志每 2 秒一条权限链路检查清单文件INTERNET 权限已声明通过这四关后往物联网方向走有三条主线一是把 Handler 的模拟数据换成真实 HTTP 请求周期性从服务器拉数据二是接入 MQTT 客户端库订阅设备主题收到消息后更新界面三是把数据存到本地数据库断网时也能看历史曲线。每条主线都不难但都建立在 FirstApp 这套最小工程之上。我自己的教训是刚接触安卓时总觉得 FirstApp 太简单跳过它直接写网络请求结果环境、线程、权限三个问题混在一起排查了两天才发现只是没加网络权限。后来我每接手一个新方向都老老实实先建一个最小工程跑通整条链路再往里面填业务。这个习惯帮我省下了大量看起来是业务问题、实际是工程问题的时间。希望帮到你。本文还有配套的精品资源点击获取