graph TD
    A[用户] -->|用户与视图交互| B[视图]
    B -->|请求处理| C[控制器]
    C -->|请求模型提供数据| D[模型]
    D -->|从数据库请求数据| E[(数据库)]
    E -->|来自数据库的响应| D
    D -->|返回数据| C
    C -->|渲染内容| B
    B -.-> A

    %% 颜色和样式增强
    style A fill:#f9c1c1,stroke:#333,stroke-width:2px
    style B fill:#ffff99,stroke:#333,stroke-width:2px
    style C fill:#d9f9a1,stroke:#333,stroke-width:2px
    style D fill:#a1c1f9,stroke:#333,stroke-width:2px
    style E fill:#ff9999,stroke:#333,stroke-width:2px

    %% 分离用户和数据库
    subgraph 用户交互
        A
        B
    end

    subgraph 后端
        C
        D
        E
    end

• App 模块： 包含应用源代码、资源和应用级设置（如 AndroidManifest.xml 和 build.gradle 文件）的主模块。创建新项目时，默认的 app 模块命名为“app”。
• Library 模块： (项目视图模式) 外部库，包含可作为依赖项在其他应用模块或项目中使用的可重用代码。它生成一个 Android 归档 (AAR) 文件。

• 项目文件：

  • build.gradle：包含插件声明和所有子项目通用配置的根构建文件。
  • settings.gradle：包含全局构建信息，包括项目名称和要包含的子项目。
  • local.properties：包含与本地机器相关的属性，例如 Android SDK 位置（已从源代码控制中排除），您也可以在此处添加 API 密钥。

• 目录结构：

  • src/main/AndroidManifest.xml：声明有关应用的基本信息，包括组件和权限。
  • src/main/java：包含应用的 Java 或 Kotlin 源代码。
  • src/main/res：包含布局、可绘制对象和字符串等资源文件。

[FR] \\

• Module App : Le module principal contenant le code source, les ressources et les paramètres de l'application (AndroidManifest.xml, build.gradle).
• Module Bibliothèque : (Mode Vue Projet) Contient du code réutilisable sous forme de fichier AAR.

• Fichiers du Projet :

  • build.gradle, settings.gradle, local.properties.

• Structure des Dossiers :

  • src/main/AndroidManifest.xml
  • src/main/java
  • src/main/res

有关更详细的信息，请参阅原始文档。

• 活动 (Activities)： 活动代表具有用户界面的单个屏幕。它们是与用户交互的入口点。Fragment 拥有自己的生命周期，与宿主活动的生命周期紧密相关。这允许更好地控制 UI 组件及其状态管理。

[FR] \\

• Activités : Les activités représentent une seule interface utilisateur et sont le point d'entrée pour interagir avec l'utilisateur. Les fragments ont leur propre cycle de vie, étroitement lié à celui de l'activité hôte, ce qui permet un meilleur contrôle des composants UI et de leur gestion d'état.

有关更多详细信息，您可以参考原始文档或 Android 架构指南。

public class MainActivity extends AppCompatActivity {
  // 活动代码
}
Fragments: Fragments introduce modularity into your app’s UI by letting you divide the UI into discrete chunks. This makes it easier to manage and reuse components across different parts of your app.

• Fragment： Fragment 通过允许您将 UI 分割成离散的块，将模块化引入到您的应用 UI 中。这使得在应用的不同部分管理和重用组件变得更加容易。

[FR] \\

• Fragments: : Les fragments introduisent la modularité dans l'interface utilisateur de votre application en vous permettant de diviser l'interface en blocs distincts. Cela facilite la gestion et la réutilisation des composants dans différentes parties de l'application.

FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
transaction.replace(R.id.fragment_container, new ExampleFragment());
transaction.addToBackStack(null);
transaction.commit();

• 服务 (Services)： 服务在后台运行，以执行长时间运行的操作或为远程进程执行工作。示例：音乐播放器应用可能会使用服务在用户使用其他应用时在后台播放音乐。

[FR] \\

• Services : Les services s'exécutent en arrière-plan pour effectuer des opérations de longue durée ou des tâches pour des processus distants. Exemple : Une application de lecteur de musique peut utiliser un service pour jouer de la musique en arrière-plan pendant que l'utilisateur utilise une autre application.

public class MusicService extends Service {
  // 服务代码
}

• 内容提供者 (Content Providers)： 内容提供者管理对结构化数据集的访问。它们封装数据并提供定义数据安全的机制。简而言之，内容提供者是 Android 允许应用与其他应用共享数据的方式。示例：存储用户联系人的应用可能会使用内容提供者来管理联系人数据。

[FR] \\

• Content Providers : Les content providers gèrent l'accès à un ensemble structuré de données. Ils encapsulent les données et fournissent des mécanismes pour définir la sécurité des données. En résumé, un Content Provider permet aux applications Android de partager leurs données avec d'autres applications. Exemple : Une application qui stocke les contacts d'un utilisateur peut utiliser un content provider pour gérer ces données de contact.

public class ContactsProvider extends ContentProvider {
  // 提供者代码
}

• 广播接收器 (Broadcast Receivers)： 广播接收器响应系统范围的广播公告。它们使应用能够监听来自系统或其他应用的特定广播消息。示例：应用可能会使用广播接收器来检测设备电量何时不足。

[FR] \\

• Broadcast Receivers : Les broadcast receivers réagissent aux annonces système globales. Ils permettent à l'application d'écouter des messages spécifiques du système ou d'autres applications. Exemple : Une application peut utiliser un broadcast receiver pour détecter lorsque la batterie de l'appareil est faible.

batteryLevel = new BatteryLevel();
mContext.registerReceiver(batteryLevel, new IntentFilter(Intent.ACTION_BATTERY_LOW));

• 意图 (Intents)： 意图是用于请求其他应用组件执行操作的消息对象。它们促进了不同组件之间的通信。示例：意图可用于启动新活动或发送广播。

[FR] \\

• Intents : Les intents sont des objets de messagerie utilisés pour demander une action à un autre composant de l'application. Ils facilitent la communication entre différents composants. Exemple : Un intent peut être utilisé pour démarrer une nouvelle activité ou envoyer une diffusion (broadcast).

Intent intent = new Intent(this, NewActivity.class);
startActivity(intent);

• 布局 (Layouts)： 布局是容器，以特定方式容纳和排列视图。它们定义了 UI 组件的结构和定位。常见布局：

  • LinearLayout：将视图排列成单行或单列。
  • RelativeLayout：相对于彼此或父容器定位视图。
  • ConstraintLayout：一种灵活的布局，允许您创建具有扁平视图层次结构的复杂布局。
  • FrameLayout：一种简单的布局，将视图堆叠在一起。
  • GridLayout：以网格格式排列视图。
  • 布局编辑器：使用 Android Studio 中的布局编辑器直观地设计您的 UI。从面板中拖放 UI 组件，并使用属性面板配置其属性。

• 视图 (Views)： 视图是 Android 用户界面的基本构建块。它们代表用户与之交互的 UI 组件，例如按钮、文本字段、图像等。常见视图：

  • TextView：向用户显示文本。
  • Button：可点击的按钮。
  • ImageView：显示图像。
  • EditText：用于用户输入的文本字段。
  • ListViews
  • RecyclerView：用于在可滚动列表中显示大数据集的灵活视图。
  • ListViews 和 Adapters：ListViews 是用于在列表中显示项目的 Android 元素。Adapters 用于将数据数组绑定到 ListView。它是一个可以处理单个项目列表的简单适配器。

[FR] \\

• Layouts : Les layouts sont des conteneurs qui organisent et disposent les vues dans une interface utilisateur.

  • LinearLayout : Dispose les vues en une seule ligne ou colonne.
  • RelativeLayout : Positionne les vues les unes par rapport aux autres ou au conteneur parent.
  • ConstraintLayout : Permet des mises en page complexes.
  • FrameLayout : Empile les vues les unes sur les autres.
  • GridLayout : Organise les vues en grille.
• Views : Composants de base de l'interface utilisateur, comme
• TextView : Affiche du texte à l'utilisateur.
• Button : Un bouton cliquable.
• ImageView : Affiche une image.
• EditText : Un champ de texte pour la saisie de l'utilisateur.
• ListView : Affiche une liste d'éléments.
• RecyclerView : Vue flexible pour afficher de grandes séries de données dans une liste défilante.
• ListViews et Adapters : ListViews sont utilisés pour afficher des listes, et les Adapters lient les données à cette liste.

ArrayAdapter<String> adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, dataArray);
listView.setAdapter(adapter);

public class CustomAdapter extends BaseAdapter {
  // 自定义适配器的实现
}

• XML 布局：使用 XML 进行设计。

  
  xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:orientation="vertical">
  
  
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Hello, World!" />
  
  
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Click Me" />
  

• Material Design 原则介绍： Material Design 是 Google 开发的一种设计系统，旨在跨各种平台（包括 Android、iOS、Flutter 和 Web）创建高质量的数字体验。它的灵感来自物理世界及其纹理，结合了印刷设计的原则，以创造一种连贯且沉浸式的用户体验。使用 Material Design

  • 将 Material 组件添加到您的项目中：打开您的 build.gradle 文件并添加以下依赖项：

[FR]
Introduction aux principes du Material Design : Material Design est un système de conception développé par Google pour créer des expériences numériques de haute qualité sur Android, iOS, Flutter et le web. Inspiré du monde physique et des textures, il incorpore des principes du design imprimé pour offrir une expérience utilisateur immersive.

• Ajouter des composants Material à votre projet : Ouvrez votre fichier `build.gradle` et ajoutez la dépendance suivante :

implementation 'com.google.android.material:material:1.4.0'

更新您的应用主题：

 name="AppTheme" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
    
     name="colorPrimary">@color/primary
     name="colorPrimaryVariant">@color/primaryVariant
     name="colorOnPrimary">@color/onPrimary
     name="colorSecondary">@color/secondary

在您的布局中使用 Material 组件。示例 Material 按钮

    android:id="@+id/button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Material Button" />

处理用户输入：示例按钮。

XML

    android:id="@+id/button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Material Button" />

JAVA

MaterialButton button = findViewById(R.id.materialButton);
button.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // 处理按钮点击
    }
});

使用数据

• 使用 SharedPreferences 管理数据： SharedPreferences 是一种将少量数据存储为键值对的简单方法。 [FR] \\

• Gérer les données avec SharedPreferences : SharedPreferences est un moyen simple de stocker de petites quantités de données sous forme de paires clé-valeur. Cela permet de sauvegarder des préférences d'utilisateur ou des paramètres de l'application de manière persistante.

  获取 SharedPreferences 实例：

  SharedPreferences sharedPreferences = getSharedPreferences("MyPrefs", Context.MODE_PRIVATE);

  将数据保存到 SharedPreferences：

  SharedPreferences.Editor editor = sharedPreferences.edit();
  editor.putString("key", "value");
  editor.apply();

  从 SharedPreferences 检索数据：

  String value = sharedPreferences.getString("key", "default_value");

• Android 网络基础（使用 REST API）

• Android 权限介绍

  <uses-permission android:name="android.permission.INTERNET" />

• Retrofit
• OkHttp3 使用 OkHttp3：将 OkHttp3 依赖项添加到您的 build.gradle 文件中：

  implementation 'com.squareup.okhttp3:okhttp:4.9.1'

进行网络请求 您可以使用 OkHttp3 进行同步和异步网络请求。以下是如何执行 GET 请求的示例：

同步 GET 请求

  OkHttpClient client = new OkHttpClient();
  Request request = new Request.Builder()
      .url("https://api.example.com/data")
      .build();

  try (Response response = client.newCall(request).execute()) {
      if (response.isSuccessful()) {
          String responseData = response.body().string();
          // 处理响应
      }
  } catch (IOException e) {
      e.printStackTrace();
  }

异步 GET 请求

  OkHttpClient client = new OkHttpClient();
  Request request = new Request.Builder()
      .url("https://api.example.com/data")
      .build();

  client.newCall(request).enqueue(new Callback() {
      @Override
      public void onFailure(Call call, IOException e) {
          e.printStackTrace();
      }

      @Override
      public void onResponse(Call call, Response response) throws IOException {
          if (response.isSuccessful()) {
              String responseData = response.body().string();
              // 处理响应
          }
      }
  });

• onCreate()

调用时机： 活动首次创建时。 目的： 初始化活动。这是您应该执行一次性设置程序的地方，例如创建 UI、初始化变量以及将数据绑定到列表。 示例：

[FR]
Appelée lorsque : L'activité est créée pour la première fois. But : Initialiser l'activité. C'est ici que vous devez effectuer les procédures de configuration uniques, telles que la création de l'interface utilisateur, l'initialisation des variables, et le binding des données aux listes. Exemple :

@Override
 protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
     // 在此处初始化组件
 }

• onStart()

调用时机： 活动对用户可见时。 目的： 准备活动进入前台并变得可交互。 示例：

[FR]
Appelée lorsque : L'activité devient visible pour l'utilisateur. But : Préparer l'activité à entrer au premier plan et à devenir interactive. Exemple :

 @Override
 protected void onStart() {
     super.onStart();
     // 执行使活动可见的任务
 }

• onResume()

调用时机： 活动开始与用户交互时。 目的： 恢复任何暂停的 UI 更新、动画或其他正在进行的操作。

[FR]
Appelée lorsque : L'activité commence à interagir avec l'utilisateur. But : Reprendre les mises à jour de l'interface utilisateur en pause, les animations ou d'autres actions en cours.

@Override
protected void onResume() {
        super.onResume();
        // 恢复与用户的交互
}

• onDestroy()

调用时机： 活动即将被销毁时。 目的： 清理任何需要释放的资源，例如线程或数据库连接。

[FR]
Appelée lorsque : L'activité est sur le point d'être détruite. But : Nettoyer toutes les ressources, telles que les threads ou les connexions à la base de données, qui doivent être libérées.

@Override
protected void onDestroy() {
        super.onDestroy();
        // 清理资源
}

public class Car {
        // 字段
        private String color;
        private String model;

        // 构造函数
        public Car(String color, String model) {
            this.color = color;
            this.model = model;
        }

        // 方法
        public void displayInfo() {
            System.out.println("Car model: " + model + ", Color: " + color);
        }
    }

    Car myCar = new Car("Red", "Toyota");
    myCar.displayInfo(); // 输出: Car model: Toyota, Color: Red

      public class Calculator {
          // 相加两个数字的方法
          public int add(int a, int b) {
              return a + b;
          }

          // 相减两个数字的方法
          public int subtract(int a, int b) {
              return a - b;
          }
      }

public interface MyInterface {
        void myMethod();
    }

public class MyClass implements MyInterface {
        @Override
        public void myMethod() {
            // myMethod 的实现
        }
    }