【Trae+AI】和Trae学习搭建App_2.2.1：第4章·安卓APP调用Express后端实战1：前端调用后端

📚前言

跟着trae规划的学习开发安卓手机app的教程，一步一步学习实践，总规划见下面文档

【Trae+AI】和Trae学习搭建App_00：总项目规划_trae 封装apk-CSDN博客

下面开始规划的第四章，开始之前还有点事要说。

🌍战略调整

在进行核心API实现之前，现把前后端连起来，现了解整体运行机制，这样会更有成就感。

实践方式，尽量手搓，即Android Studio+文本编辑器+CMD+AI教程指导【豆包】

✍️AI提示语：

我要学习安卓手机app的开发，我已经完成第一章规划，第二章：开发环境配置（包括Android Studio、node.js、MongoDB、Git），以及第三章，后端基础框架 Express框架搭建 数据库模型设计（用户、任务、分类） 中间件配置（日志、跨域、认证）。请为我规划第四章的教学内容，安卓APP调用后端Express的详细教程，可以分多次输出，一定要有详细的操作过程，和对应原理，指导初学的我逐步掌握。

第二部分：后端API开发

第四章 安卓APP调用Express后端实战

一、第四章整体教学规划（语言Kotlin）

本章核心目标：基于Kotlin语言（Android官方首选开发语言），从零基础到完整调用后端所有核心接口（登录、任务CRUD、分类管理），兼顾「手把手操作步骤」和「底层原理」，整体分为6个部分，适配初学者节奏：

二、第四章（第一部分）：安卓端网络通信基础准备（Kotlin版）

学习目标

之前教程参考

• •  【App开发】01：Android Studio 安装配置-CSDN博客
  • 【App开发】02：Android Studio项目环境设置_android studio 项目环境配置-CSDN博客
  • 【App开发】03：Android Studio发布应用_android studio发布app-CSDN博客
  • 【App开发】04：Android Studio第一个项目之页面开发_android studio开发-CSDN博客

前置知识回顾

• 后端已启动：http://localhost:3000（安卓模拟器访问本地后端需用 http://10.0.2.2:3000，原理后文讲）；
• 后端已有核心接口：/api/login（登录）、/api/tasks（任务查询）、/test（测试接口）。

步骤1：创建Kotlin版安卓项目（详细操作）

操作流程（手把手）

说明

• Kotlin是Android官方2017年宣布的首选开发语言，相比Java：
  • 语法更简洁（少样板代码，如无需写findViewById）；
  • 天然支持空安全（避免空指针异常，初学者踩坑少）；
  • 内置协程（优雅处理异步操作，替代Java的Thread）；
• Minimum SDK选7.0：既保证兼容性，又能使用Kotlin协程、OkHttp3等现代API。

步骤2：配置安卓网络权限（必做）

操作流程

原理说明（和Java版一致，补充Kotlin无影响）

📌Android应用中的权限声明

Android 应用清单文件（AndroidManifest.xml）中的权限声明是应用向系统申请访问设备资源 / 功能的核心方式，Android 官方将权限分为 普通权限（Normal）、危险权限（Dangerous）、特殊权限（Special） 三类，普通权限只需清单声明，危险权限需动态申请，特殊权限需引导用户到系统设置授权，且所有权限需适配对应 Android 版本的行为变更。

➡️更详细内容见附录部分。

步骤3：添加核心依赖（OkHttp3 + Gson + Kotlin协程）

操作流程

🧩实际操作界面参考：

添加依赖后，同步前的界面：

同步后，成功界面如下：

📖原理说明（Kotlin专属补充）

📌app/build.gradle文件中依赖的两种书写格式：

💡建议：两种写法都能正确引入依赖，推荐新建项目（AGP 7.0+）优先使用版本目录写法。

步骤4：基础测试——Kotlin版安卓访问Express后端（验证连通性）

前置准备：确保后端正常运行

🧩实际操作参考：

修改app.js后，通过浏览器，访问测试地址：localhost:3000/test，显示如下信息：

步骤4.1：修改布局文件（显示请求结果）

打开app/src/main/res/layout/activity_main.xml，添加TextView用于显示请求结果：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">

<TextView
android:id="@+id/tvResult"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="等待请求…"
android:textSize="16sp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

🧩界面设置参考：

步骤4.2：编写Kotlin网络请求代码（协程版）

打开MainActivity.kt，编写核心代码（Kotlin+协程，适配Android最佳实践）：

package com.example.androidexpressdemo

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import android.widget.TextView
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
import okhttp3.OkHttpClient
import okhttp3.Request
import java.io.IOException

class MainActivity : AppCompatActivity() {
// 日志标签（调试用）
private val TAG = "NetworkTest"
// 后端地址：安卓模拟器中localhost映射为10.0.2.2（关键！）
private val BASE_URL = "http://10.0.2.2:3000"

// 延迟初始化TextView（Kotlin空安全特性，避免空指针）
private lateinit var tvResult: TextView

override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)

// 绑定UI控件（Kotlin无需findViewById，直接用id引用，需开启视图绑定或直接引用）
tvResult = findViewById(R.id.tvResult)

// 1. 创建OkHttp客户端（全局单例更佳，此处简化）
val okHttpClient = OkHttpClient()

// 2. 构建GET请求（访问后端/test接口）
val request = Request.Builder()
.url("$BASE_URL/test") // 拼接测试接口地址
.get() // 指定GET请求（可省略，默认GET）
.build()

// 3. 启动协程处理网络请求（Kotlin核心，替代Java的Thread）
GlobalScope.launch(Dispatchers.Main) {
// 子线程执行网络请求（Dispatchers.IO：IO密集型任务）
val responseResult = withContext(Dispatchers.IO) {
try {
// 执行同步请求（OkHttp同步调用，协程中无阻塞问题）
val response = okHttpClient.newCall(request).execute()
// 获取响应体字符串
val responseBody = response.body?.string()
// 返回成功结果
"请求成功：$responseBody"
} catch (e: IOException) {
// 捕获网络异常
e.printStackTrace()
"请求失败：${e.message}"
}
}

// 4. 主线程更新UI（Dispatchers.Main：自动切换到主线程）
tvResult.text = responseResult
// 日志打印结果（调试用）
Log.d(TAG, "后端返回：$responseResult")
}
}
}

📌相关说明

• GlobalScope的提示
  • 如下图
  • 警告说明

    • GlobalScope的定义：它是一个全局协程作用域，不绑定任何任务，用于启动 “全应用生命周期” 的协程，但不会保持进程存活（类似守护线程）。

    • 风险点：GlobalScope是 “敏感 API”，易引发资源 / 内存泄漏

  • 解决方案

    • Activity/Fragment 中：使用lifecycleScope（自动绑定页面生命周期，页面销毁时协程自动取消） lifecycleScope.launch(Dispatchers.Main) {
      // 网络请求等操作
      } 实际代码示例：
    • ViewModel 中：使用viewModelScope（绑定 ViewModel 生命周期，ViewModel 销毁时协程自动取消） viewModelScope.launch(Dispatchers.Main) {
      // 网络请求等操作
      }
• 语法知识点
  • val：Kotlin 关键字，声明不可变变量（类似 Java 的 final）
  • OkHttpClient：OkHttp 库的核心客户端类，负责管理网络请求的所有配置（如超时时间、拦截器、连接池等）、发起请求、处理响应；
    • OkHttpClient()：调用 OkHttpClient 的无参构造函数，创建一个默认配置的客户端实例。

      • 通过无参构造创建的 OkHttpClient 会使用 OkHttp 的默认配置，核心默认值如下：

        配置项默认值作用

        连接超时时间	10 秒	客户端与服务器建立连接的最大等待时间
        读取超时时间	10 秒	连接建立后，读取服务器响应数据的最大等待时间
        写入超时时间	10 秒	向服务器写入请求数据的最大等待时间
        连接池	5 个并发连接，5 分钟空闲超时	复用 HTTP 连接（避免重复创建连接，提升性能）
        拦截器	空	无自定义拦截器（可后续通过 newBuilder() 添加，如日志、请求头拦截）
        重定向策略	允许自动重定向	遇到 3xx 状态码时，自动跳转至新地址

  • Request.Builder().url("$BASE_URL/test") .get() .build()
    • Request：OkHttp 中封装 HTTP 请求的核心类，包含请求的 URL、方法、头信息、请求体等所有参数；
    • Builder()：调用 Request 的构建器构造函数；
    • .url()：Request.Builder 的核心方法，用于设置请求的目标 URL；
    • .get()：显式指定该请求为 HTTP GET 方法；
    • .build()：Request.Builder 的最终方法，根据前面配置的参数（URL、请求方法等），生成不可变的 Request 实例；
      • 调用后，构建器的配置会固化到 Request 对象中，无法再修改（如需调整，需重新创建 Builder）。

  • 启动协程处理网络请求

    • lifecycleScope：绑定 Activity/Fragment 生命周期的协程作用域（替代危险的 GlobalScope），页面销毁（onDestroy）时，该作用域下的所有协程会自动取消；

    • launch(Dispatchers.Main)：

      • launch：启动一个新的协程（协程构建器）；
      • Dispatchers.Main：指定协程的默认调度器为 “主线程（UI 线程）”—— 即协程的代码块默认在主线程执行，且最终结果会回到主线程（方便更新 UI）

    • withContext(Dispatchers.IO) 

      • withContext：协程的 “挂起函数”，作用是切换到指定线程执行代码块，执行完成后切回原线程，并将代码块的返回值赋值给 responseResult。
      • Dispatchers.IO：协程的 IO 调度器，专门用于处理 IO 密集型任务（网络请求、文件读写、数据库操作等），底层是线程池，自动管理线程复用，避免手动创建 Thread 的繁琐。
      • 核心逻辑：把耗时的网络请求 “丢到 IO 线程执行”，执行完后自动切回 launch 指定的主线程。

    • okHttpClient.newCall(request).execute()

      • okHttpClient.newCall(request)：将之前构建的 Request 对象包装为 OkHttp 的 Call 对象（表示一次可执行的请求）；
      • execute()：OkHttp 的同步请求方法（区别于 enqueue 异步回调）：
        • 同步请求会 “阻塞当前线程”，但这里运行在 Dispatchers.IO 线程，因此不会阻塞主线程；
    • response.body?.string()
      • response.body：OkHttp 的响应体对象（ResponseBody），封装服务器返回的数据；
      • ?.string()：安全调用响应体的 string() 方法（避免空指针），将响应体转为字符串（如 JSON 字符串）；
        • ⚠️ 注意：string() 只能调用一次（调用后响应体流会关闭），如需多次使用需先保存为变量。
  • "请求成功：$responseBody"，在 Kotlin 中，不需要显式写 return 就能返回结果
    • 在 Kotlin 中，带有代码块的 lambda 表达式、匿名函数、普通函数，如果没有显式写 return，会默认将代码块的「最后一行语句的结果」作为返回值（前提是代码块有返回类型约束）。
  • Log.d(TAG, "后端返回：$responseResult")：在Logcat窗口查看输出的日志信息

步骤4.3：运行测试（验证连通性）

程序部署到模拟器或真机中，有相关部署提示，如图：

​​​​​​​

成功会提示：服务器端相应的访问信息如下：

第一部分学习总结（Kotlin版）

完成Kotlin版安卓项目搭建，解决“安卓访问后端”的3个核心问题：

• 权限：配置INTERNET和明文HTTP允许；
• 依赖：引入OkHttp3（网络）、Gson（JSON）、协程（异步）；
• 地址：模拟器访问电脑后端；

验证了Kotlin端与Express后端的连通性，为后续接口调用打下基础。

附录

Android权限划分

Android 官方将权限分为 普通权限（Normal）、危险权限（Dangerous）、特殊权限（Special） 三类，以下是按功能分类的常用权限及核心说明：

一、权限分类基础

二、常用权限按功能分类详解

1. 网络相关权限（普通权限为主）

2. 存储相关权限（危险权限，Android 10+ 有特殊适配）

3. 位置相关权限（危险 / 特殊权限）

4. 相机 / 媒体相关权限（危险权限）

5. 电话 / 通讯相关权限（危险 / 普通）

6. 系统 / 设备控制相关权限（普通 / 特殊）

7. 日历 / 联系人 / 日程（危险权限）

8. 传感器 / 硬件相关（普通权限为主）

三、特殊权限声明注意事项

四、如何快速查询所有官方权限

总结

清单文件中的权限声明需遵循 “最小权限原则”—— 仅声明应用必需的权限，避免过度申请隐私权限（否则会被应用商店审核拒绝，或降低用户信任）。普通权限只需清单声明，危险权限需动态申请，特殊权限需引导用户到系统设置授权，且所有权限需适配对应 Android 版本的行为变更。