Flutter App Settings 鸿蒙使用指南

b13053810049

1119人浏览 · 2025-12-18 14:31:15

b13053810049 · 2025-12-18 14:31:15 发布

1. 插件介绍

Flutter App Settings 是一个用于打开设备和应用设置页面的 Flutter 插件，它允许开发者在应用程序中轻松跳转到各种系统设置页面。该插件基于原生平台的 API 实现，提供了统一的跨平台接口。

核心功能

系统设置跳转：支持打开设备的各种系统设置页面，如 WiFi、定位、蓝牙等
应用设置跳转：支持打开应用自身的设置页面
设置面板支持：支持打开系统设置面板（如音量、网络等）
跨平台支持：统一的 API 接口，支持 Android、iOS、macOS 和 HarmonyOS
丰富的设置类型：提供多种设置类型枚举，满足不同场景需求

鸿蒙平台适配

本版本的 Flutter App Settings 是专门为 HarmonyOS 平台定制修改的版本，基于 app_settings@1.0.4 开发，提供了完整的设置页面跳转功能。所有核心 API 在 HarmonyOS 平台上都能正常工作，确保开发者能够获得一致的开发体验。

2. 包的引入

由于本版本的 Flutter App Settings 是自定义修改版本，需要通过 Git 形式引入。以下是在 Flutter 项目中引入该插件的步骤：

修改 pubspec.yaml

在项目的 pubspec.yaml 文件中添加以下配置：

dependencies:
  # 添加 App Settings 主依赖
  app_settings:
    git:
      url: "https://gitcode.com/openharmony-sig/fluttertpc_app_settings"

# 添加 App Settings 鸿蒙平台支持依赖
dev_dependencies:
  app_settings_ohos:
    git:
      url: "https://gitcode.com/openharmony-sig/fluttertpc_app_settings"
      path: ./ohos

执行依赖获取

在项目根目录下执行以下命令，获取插件依赖：

flutter pub get

3. API 调用示例

Flutter App Settings 提供了丰富的 API，以下是常用功能的使用示例：

导入包

首先，在需要使用 App Settings 的 Dart 文件中导入包：

import 'package:app_settings/app_settings.dart';

打开系统设置页面

使用 openAppSettings() 方法可以打开各种系统设置页面，通过指定 type 参数来选择要打开的设置类型：

// 打开 WiFi 设置页面
AppSettings.openAppSettings(type: AppSettingsType.wifi);

// 打开定位设置页面
AppSettings.openAppSettings(type: AppSettingsType.location);

// 打开蓝牙设置页面
AppSettings.openAppSettings(type: AppSettingsType.bluetooth);

打开应用设置页面

使用 AppSettingsType.settings 可以打开应用自身的设置页面：

// 打开应用设置页面
AppSettings.openAppSettings(type: AppSettingsType.settings);

在新任务中打开设置页面

在 Android 平台上，可以通过设置 asAnotherTask 参数为 true，在新的 Activity 中打开设置页面：

// 在新任务中打开设备设置页面
AppSettings.openAppSettings(type: AppSettingsType.device, asAnotherTask: true);

打开设置面板

使用 openAppSettingsPanel() 方法可以打开系统设置面板：

// 打开音量设置面板
AppSettings.openAppSettingsPanel(AppSettingsPanelType.volume);

// 打开网络设置面板
AppSettings.openAppSettingsPanel(AppSettingsPanelType.internetConnectivity);

支持的设置类型

HarmonyOS 平台支持以下设置类型：

设置类型	描述
`accessibility`	无障碍设置
`alarm`	闹钟设置
`apn`	APN 设置
`appLocale`	应用语言设置
`batteryOptimization`	电池优化设置
`bluetooth`	蓝牙设置
`dataRoaming`	数据漫游设置
`date`	日期设置
`developer`	开发者设置
`device`	设备设置
`generalSettings`	通用设备设置
`display`	显示设置
`hotspot`	热点设置
`internalStorage`	内部存储设置
`location`	位置设置
`lockAndPassword`	锁屏和密码设置
`nfc`	NFC 设置
`notification`	通知设置
`security`	安全设置
`settings`	应用设置
`sound`	声音设置
`subscriptions`	订阅设置
`vpn`	VPN 设置
`wifi`	WiFi 设置
`wireless`	无线设置

完整示例

以下是一个完整的 Flutter Widget 示例，展示了如何使用 App Settings 插件：

import 'package:flutter/material.dart';
import 'package:app_settings/app_settings.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<Widget> getOpenAppSettingsActions() {
    return [
      ListTile(
        title: const Text('WiFi 设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.wifi),
      ),
      ListTile(
        title: const Text('定位设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.location),
      ),
      ListTile(
        title: const Text('蓝牙设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.bluetooth),
      ),
      ListTile(
        title: const Text('通知设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.notification),
      ),
      ListTile(
        title: const Text('显示设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.display),
      ),
      ListTile(
        title: const Text('应用设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.settings),
      ),
      ListTile(
        title: const Text('电池优化设置'),
        onTap: () => AppSettings.openAppSettings(type: AppSettingsType.batteryOptimization),
      ),
    ];
  }

  @override
  Widget build(BuildContext context) {
    final appSettingsActions = getOpenAppSettingsActions();

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('App Settings 示例应用'),
        ),
        body: ListView(
          children: appSettingsActions,
        ),
      ),
    );
  }
}