feat: update android

leverimmy · leverimmy · commit e91fe8acc4c2 · 2025-02-19T21:52:54.000+08:00
diff --git a/docs/frontend/android/extensions.md b/docs/frontend/android/extensions.md
@@ -3,4 +3,4 @@
 到这里文档就算结束了，但是如果想更加深入的学习 Android 开发，可以参考下面的内容
 
 - [Android 开发者官网](https://developer.android.com/docs?hl=zh-cn)：官方网站是最权威的学习资料，里面有很多教程和详尽的 API 文档，还有一些示例代码。除此之外，官网还有一些关于 Android 开发的最新动态，如新的 API 版本、新的开发工具等。
-- [Android Weekly](https://androidweekly.net/)：每周更新，汇集了互联网上有关 Android 开发的技术文章、开源项目、工具等，截至文档完成时已经更新了接近 600 期。
+- [Android Weekly](https://androidweekly.net/)：每周更新，汇集了互联网上有关 Android 开发的技术文章、开源项目、工具等，截至文档完成时已经更新了接近 600 期。
diff --git a/docs/frontend/android/index.md b/docs/frontend/android/index.md
@@ -2,7 +2,7 @@
 
 !!! info "说明"
 
-    本文基于 2023 年学生科协暑培朱煜章同学主讲的 Android 课程的讲义完成。
+    本内容根据 [2023 年科协暑培朱煜章同学的 Java 课程讲义](https://summer23.net9.org/frontend/android/)，和 [2024 年科协暑培熊泽恩同学的 Java 课程讲义](https://summer24.net9.org/frontend/android/prerequisites)整理。
 
 Android 是一个开源的、基于 Linux 开发的移动设备操作系统，编写一个 Android 应用可以使用的编程语言有 Java, Kotlin, C++ 等，本文档将以 Java 为例进行讲解。
 
@@ -14,11 +14,11 @@ Android 是一个开源的、基于 Linux 开发的移动设备操作系统，
 
 - Java 语言环境
 - 我们选择 Android Studio 作为开发平台，可以在 [Download Android Studio & App Tools - Android Developers (google.cn)](https://developer.android.google.cn/studio/) 下载。Android Studio 是一个基于 IntelliJ IDEA 的 Android 开发工具，为开发人员提供了广泛的功能和工具，用于设计、编写、调试和测试 Android 应用程序。开发中常用的功能有：
-    - 布局编辑器：Android Studio 提供了一个可视化布局编辑器，用于设计应用程序的用户界面。开发人员可以直观地添加 UI 元素、调整布局和设置属性。
-    - 调试工具：Android Studio 具有内置的调试工具，开发人员可以在代码中设置断点，跟踪变量的值，并执行逐行调试。
-    - 虚拟设备管理器：Android Studio 包含一个虚拟设备管理器，用于创建和管理模拟的 Android 设备。这使开发人员能够在没有实际设备的情况下进行应用程序的测试和调试。
-    - APK 构建工具：Android Studio 可以将应用程序打包为 Android 安装包（APK）。开发人员可以生成签名的 APK 文件，以便在设备上进行部署和分发。
-    - SDK 管理器：Android Studio 包含一个 SDK（Software Development Kit）管理器，用于下载和管理 Android 平台的各种版本和附加组件。开发人员可以根据目标设备和最低支持版本来选择所需的 SDK 组件。
+  - 布局编辑器：Android Studio 提供了一个可视化布局编辑器，用于设计应用程序的用户界面。开发人员可以直观地添加 UI 元素、调整布局和设置属性。
+  - 调试工具：Android Studio 具有内置的调试工具，开发人员可以在代码中设置断点，跟踪变量的值，并执行逐行调试。
+  - 虚拟设备管理器：Android Studio 包含一个虚拟设备管理器，用于创建和管理模拟的 Android 设备。这使开发人员能够在没有实际设备的情况下进行应用程序的测试和调试。
+  - APK 构建工具：Android Studio 可以将应用程序打包为 Android 安装包（APK）。开发人员可以生成签名的 APK 文件，以便在设备上进行部署和分发。
+  - SDK 管理器：Android Studio 包含一个 SDK（Software Development Kit）管理器，用于下载和管理 Android 平台的各种版本和附加组件。开发人员可以根据目标设备和最低支持版本来选择所需的 SDK 组件。
 
 ## 学习方法
 
@@ -28,10 +28,16 @@ Android 是一个开源的、基于 Linux 开发的移动设备操作系统，
 
 本文档可以在以下课程帮助到你：
 
-- 程序设计训练 Java 课堂
+- 程序设计训练（Java 课堂）
 - 其他存在 Android 开发需求的课程
 
 ## 资源链接
 
-- Android 开发者官方文档 <https://developer.android.google.cn/docs>
-- GitHub 上的一个 Android 包含教程、一些开源项目和工具库的合集 <https://github.com/aritraroy/UltimateAndroidReference>
+- Android 开发者[官方文档](https://developer.android.google.cn/docs)
+- GitHub 上的一个 Android 包含教程、一些开源项目和工具库的合集：https://github.com/aritraroy/UltimateAndroidReference
+
+## 相关链接
+
+- 2022 年科协暑培的 [Android 项目示例](https://github.com/xsun2001/simple-tree-hole-android)（Java 语言）
+- 2023 年科协暑培的 [Android 课程作业](https://github.com/sast-summer-training-2023/sast2023-java-and-android)
+- 2024 年科协暑培的 [Android 课程作业](https://github.com/sast-summer-training-2024/sast2024-android)
diff --git a/docs/frontend/android/resources.md b/docs/frontend/android/resources.md
@@ -132,4 +132,4 @@ Android 的资源库存储着 APP 的本地资源，包括布局文件、图片
 </menu>
 ```
 
-Android 还有更多种资源类型，这里一一介绍并不现实，想要了解更多的可以跳转 [资源类型简介](https://developer.android.google.cn/guide/topics/resources/available-resources?hl=zh-cn)。
+Android 还有更多种资源类型，这里一一介绍并不现实，想要了解更多的可以跳转 [资源类型简介](https://developer.android.google.cn/guide/topics/resources/available-resources?hl=zh-cn)。
diff --git a/docs/frontend/android/structure.md b/docs/frontend/android/structure.md
@@ -1,32 +1,72 @@
 # Android 项目的构成
 
-## 项目概览
+## Manifests
 
-在 Android Studio 中新建一个空项目，可以看到项目结构如下
+在 Android 应用中，`AndroidManifest.xml` 文件是必不可少的。它是 Android 应用的核心配置文件，它包含了应用的元数据和配置信息，用于描述应用的结构和行为。这个文件为系统提供了关于应用的各种关键信息，如应用的**包名**、**应用图标**、**版本信息**、**支持的 Android 版本**、**对外暴露的组件**（如 Activity、Service、BroadcastReceiver 等），以及其他系统需要知道的设置和权限。
 
-<center>
-    <img src="https://i.imgs.ovh/2023/11/24/MBny0.png" width="30%">
-</center>
+以下是一个 `AndroidManifest.xml` 文件的示例：
 
-## 项目文件
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
-项目中最关键的就是 app 目录下的项目文件，它包含几个重要的部分：
+    <application
+        android:allowBackup="true"
+        android:dataExtractionRules="@xml/data_extraction_rules"
+        android:fullBackupContent="@xml/backup_rules"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.Wordle"
+        tools:targetApi="31">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
 
-- `AndroidManifest.xml` 是应用清单文件，需要声明以下内容：
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
 
-    - 应用的软件包名称，如 com.example.myapp。
-    - 应用的组件，如应用中使用的 Activity 和 Service。
-    - 应用为访问系统或其他应用的受保护部分所需的权限，如使用网络连接的权限、读取外部储存的权限等等，具体的权限清单可以查看 [权限 API 参考文档页面](https://developer.android.com/reference/android/Manifest.permission)。
-    - 应用需要的硬件和软件功能，特别是 **minSdkversion** 和 **targetSdkversion**，前者定义了 APP 所需要的最低 API 级别，后者指定了应用的目标 API 级别，API 级别与 Android 的系统版本相对应，对应关系可查看 [什么是 API 级别](https://developer.android.com/guide/topics/manifest/uses-sdk-element?hl=zh-cn#ApiLevels)。
+</manifest>
+```
 
-- `java` 目录下存放的是 Java 源代码文件。
-- `res` 目录下包含所有非代码资源（例如 XML 布局、界面字符串和位图图像），我们将在下一节介绍 Android 的资源文件。
-- `build.gradle` 是构建工具包 Gradle 执行应用构建过程的配置文件，除了指定使用的 Java 版本以及 API 级别外，应用所使用的依赖项也需要添加到 `build.gradle` 中，如
-    ```text
-    dependencies {
-        implementation 'com.google.android.material:material:1.8.0'
-        implementation 'com.squareup.okhttp3:okhttp:4.9.2'
-    }
-    ```
+## Fragments/Activities/Services/Adapters/Intents
 
-其他文件在创建项目时就已经由 Android Studio 帮助你完成了，几乎不需要更多的修改。
+这些组件是 Android 应用的基本组成部分，位于 `app/src/main/java/` 文件夹里。
+
+- **Fragments**：可以看作是活动的一部分，用于管理用户界面的一部分。
+- **Activities**：是应用中的一个单独的屏幕，用户可以与之交互。
+- **Services**：用于在后台执行长时间运行的操作，而不会干扰用户界面。
+- **Adapters**：用于将数据绑定到视图组件，如列表视图或网格视图。
+- **Intents**：用于启动活动、服务或广播，还可以在应用之间传递数据。
+
+其中，`MainActivity.java` 通常作为应用的主入口点，它是一个继承自 `Activity` 的类，用于定义应用的主界面和用户交互逻辑。
+
+## Tests
+
+测试是确保应用质量和稳定性的重要部分。测试文件通常位于以下两个目录：
+
+- `app/src/test/`：包含单元测试，这些测试在开发人员的机器上运行。
+- `app/src/androidTest/`：包含仪器测试，这些测试在设备或模拟器上运行。
+
+## Resources
+
+资源文件是应用的非代码部分，包括图像、字符串、颜色定义等。资源文件位于 `app/src/main/res/` 文件夹中，主要包括：
+
+- `drawable/`：存放图像资源。
+- `values/`：存放字符串、颜色定义、尺寸定义等。
+- `layout/`：存放应用的布局文件，如 XML 文件。
+
+## Gradle Scripts
+
+Gradle 是 Android 应用的构建系统。Gradle Scripts 用于定义项目的构建过程和依赖关系。主要文件包括：
+
+- `gradle.properties`：定义全局配置，如最小 SDK 版本。
+- `gradle-wrapper.properties`：定义 Gradle 包装器的配置。
+- `settings.gradle.kts`：定义项目设置，如模块名称。
+- `build.gradle.kts`：定义模块的构建逻辑，包括依赖项和插件。
diff --git a/docs/frontend/android/useful-things.md b/docs/frontend/android/useful-things.md
@@ -160,4 +160,152 @@ videoView.setVideoPath(video);
 MediaController mediaController = new MediaController(getContext());
 videoView.setMediaController(mediaController);
 videoView.requestFocus();
-```
+```
+
+## 序列化与反序列化：JSON
+
+JSONObject 和 JSONArray 是在处理 JSON 数据时使用的两种基本数据结构。它们是轻量级的，并且通常用于在 Web 服务和移动应用之间传输数据。在 Android 开发中，这两个类通常由 `org.json` 库提供，这个库不是 Android 标准库的一部分，因此需要单独添加到项目中。
+
+### JSONObject
+
+JSONObject 是一个映射表，用来存储键值对，其中键是字符串，值可以是以下类型之一：
+
+- `String`
+- `Number`
+- `JSONObject`
+- `JSONArray`
+- `Boolean`
+- `null`
+
+**基本用法**:
+
+1. **创建 JSONObject**:
+
+   ```java
+   JSONObject jsonObject = new JSONObject();
+   ```
+
+2. **添加数据**:
+
+   ```java
+   jsonObject.put("key", "value");
+   jsonObject.put("key2", 123);
+   jsonObject.put("key3", anotherJsonObject);
+   ```
+
+3. **获取数据**:
+
+   ```java
+   String value = jsonObject.getString("key");
+   int number = jsonObject.getInt("key2");
+   JSONObject jobj = jsonObject.getJSONObject("key3");
+   ```
+
+4. **遍历 JSONObject**:
+
+   ```java
+   Iterator<String> keys = jsonObject.keys();
+   while (keys.hasNext()) {
+       String key = keys.next();
+       Object value = jsonObject.get(key);
+       // 处理 key 和 value
+   }
+   ```
+
+### JSONArray
+
+JSONArray 是一个列表，用于存储有序的值集合。与 JSONObject 类似，JSONArray 中的值也可以是字符串、数字、布尔值、另一个 JSONObject 或 JSONArray。
+
+**基本用法**:
+
+1. **创建 JSONArray**:
+
+   ```java
+   JSONArray jsonArray = new JSONArray();
+   ```
+
+2. **添加数据**:
+
+   ```java
+   jsonArray.put("value1");
+   jsonArray.put(123);
+   jsonArray.put(anotherJsonObject);
+   jsonArray.put(anotherJsonArray);
+   ```
+
+3. **获取数据**:
+
+   ```java
+   String value = jsonArray.getString(0);
+   int number = jsonArray.getInt(1);
+   JSONObject jobj = jsonArray.getJSONObject(2);
+   JSONArray jarray = jsonArray.getJSONArray(3);
+   ```
+
+4. **访问长度**:
+
+   ```java
+   int length = jsonArray.length();
+   ```
+
+5. **遍历 JSONArray**:
+
+   ```java
+   for (int i = 0; i < jsonArray.length(); i++) {
+       Object value = jsonArray.get(i);
+       // 处理 value
+   }
+   ```
+
+### 示例代码
+
+以下是一个简单的示例，演示了如何创建和使用 `JSONObject` 和 `JSONArray`：
+
+```java
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+public class JsonExample {
+    public static void main(String[] args) {
+        // 创建 JSONObject
+        JSONObject jsonObject = new JSONObject();
+        jsonObject.put("name", "John Doe");
+        jsonObject.put("age", 30);
+        
+        // 创建 JSONArray
+        JSONArray jsonArray = new JSONArray();
+        jsonArray.put("Apple");
+        jsonArray.put("Banana");
+        jsonArray.put("Cherry");
+        
+        // 将 JSONArray 添加到 JSONObject
+        jsonObject.put("fruits", jsonArray);
+        
+        // 输出整个 JSON 对象
+        System.out.println(jsonObject.toString());
+        
+        // 获取并输出 name
+        System.out.println(jsonObject.getString("name"));
+        
+        // 获取并遍历 fruits
+        JSONArray fruits = jsonObject.getJSONArray("fruits");
+        for (int i = 0; i < fruits.length(); i++) {
+            System.out.println(fruits.get(i));
+        }
+    }
+}
+```
+
+## 输出日志：Log
+
+在 Android 开发中，Log 类是用于输出日志信息的非常有用的工具。它属于 `android.util` 包，提供了多种方法来打印不同级别的日志信息，帮助开发者调试应用。
+
+日志信息通常包括一个标签（tag）和一个消息（message）。标签是一个简短的字符串，用于标识日志信息的来源，而消息则是要输出的具体内容。
+
+```java
+Log.d("preferenceTest", "This is a debug message.");
+```
+
+Log 类输出的日志可以在 Android Studio 的 Logcat 窗口中查看。Logcat 是一个实时日志查看工具，允许开发者根据日志级别、标签等条件过滤日志信息。
+
+使用 Log 类是 Android 开发中调试和监控应用状态的重要手段。合理使用日志可以帮助你快速定位问题并优化应用性能。
