# Preferences_sample

**Repository Path**: llince/Preferences_sample

## Basic Information

- **Project Name**: Preferences_sample
- **Description**: 本示例使用@ohos.data.preferences接口，展示了使用首选项持久化存储数据的功能。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 18
- **Created**: 2025-08-21
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#  Preferences

### Overview

This sample shows how to use the APIs provided by the @ohos.data.preferences module to persistent preferences data.

### Preview

| Default                                 | Pomelo                                 | Simplicity                                 |
|-----------------------------------------|----------------------------------------|--------------------------------------------|
| ![](screenshots/devices/default.en.png) | ![](screenshots/devices/pomelo.en.png) | ![](screenshots/devices/simplicity.en.png) |

### How to Use

1. Touch the switch button on the upper right corner of the title bar, and select the theme to switch to from the screen displayed.

2. Exit the app and then access it again. The theme before the last exit is displayed.

### Project Directory
```
├──entry/src/main/ets/
│  ├──application
│  │  └──AbilityStage.ets
│  ├──common
│  │  └──ThemeDesktop.ets             // Content of the home page
│  ├──mainability
│  │  └──MainAbility.ets
│  ├──pages
│  │  └──Index.ets                    // Home page, which contains all the APIs and data.
│  └──util
│     ├──DataSource.ets               // Data to be loaded in lazy loading mode
│     └──Logger.ets                   // Log file
└──entry/src/main/resources           // Static resources of the app
```

### How to Implement

* Switch the theme: 

  Set several sets of main data on the home page, use **preferences.getPreferences** to obtain the **Preferences** object, and use **Preferences.get()** to obtain the data to be displayed. Each time the switch button is clicked, **Preferences.put()** is called to modify the parameters. Use **Preferences.flush()** to save and refresh the file content.

  Source code reference: [Index.ets](entry/src/main/ets/pages/Index.ets)

### Required Permissions

N/A

### Dependencies

N/A

### Constraints

1. The sample app is supported only on Huawei phones running the standard system.

2. The HarmonyOS version must be HarmonyOS 5.0.5 Release or later.

3. The DevEco Studio version must be DevEco Studio 5.0.5 Release or later.

4. The HarmonyOS SDK version must be HarmonyOS 5.0.5 Release or later.