鸿蒙版 Flutter 三方库适配案例【screen-369IT编程

admin管理员组
文章数量:1037775

鸿蒙版 Flutter 三方库适配案例【screen

大家好，今天我们一起来实现一个鸿蒙版本的 screen_brightness

screen_brightness

简介

项目是一个用于控制屏幕亮度的 Flutter 插件项目，支持 Android、iOS、macOS 和 Windows 平台。

开发背景

目前社区里还有一个 screen，但是在使用的时候发现一个问题，就是目前 screen 并没有支持空安全，在 3.21 的项目里不能使用，但是为了方便开发者，我其实也做了适配，大家可以直接使用，地址：，

screen_brightness

功能丰富：不仅可以获取和设置系统屏幕亮度，还能获取和设置应用内的屏幕亮度，并且可以重置应用内的屏幕亮度到系统默认值，功能较为全面。
无需额外权限控制应用亮度：控制应用内的屏幕亮度时不需要额外的权限，使用起来更加方便。
提供亮度变化监听：提供了系统和应用屏幕亮度变化的监听流，便于开发者实时获取屏幕亮度的变化情况，在需要根据亮度变化做出相应处理的场景下非常有用。
支持自动重置：具有自动重置应用内屏幕亮度的功能，可以通过设置自动将应用内的屏幕亮度重置为系统亮度，减少开发者手动管理的负担。
适用场景广泛：适用于需要对应用内屏幕亮度进行精细控制和管理的应用，比如阅读类应用、视频播放应用等，能够为用户提供更好的视觉体验。

screen

简洁易用：API 相对简洁，使用起来较为简单直接，对于只需要基本屏幕亮度控制功能的开发者来说，能够快速上手和集成。
同时支持屏幕保持唤醒：除了屏幕亮度控制外，还提供了屏幕保持唤醒的功能，方便在需要防止屏幕自动锁屏的场景下使用，如视频播放、游戏等应用。
适用场景广泛：适用于对屏幕状态控制有多种需求的应用，尤其是需要同时控制屏幕亮度和防止屏幕睡眠的应用，能够满足基本的屏幕管理需求。

总结

screen_brightness 在屏幕亮度控制方面功能更加强大和全面，适合对屏幕亮度有精细控制需求的应用；而 screen 则在屏幕状态控制的多样性上更具优势，适合需要同时控制屏幕亮度和防止屏幕睡眠的应用。开发者可以根据具体的应用场景和需求来选择合适的库。

但是相比较来说，screen_brightness 目前一直在更新，所以我们今天就一起来看看如何对这个库进行适配。

一、准备工作

flutter 开发环境已配置：参考.md

下载待适配的三方插件：官方插件库地址/

目前 screen_brightness 在 github 上。

二、插件目录

lib：是对接 dart 端代码的入口，由此文件接收到参数后，通过 channel 将数据发送到原生端；

android：安卓端代码实现目录；

ios：ios 原生端实现目录；

example：一个依赖于该插件的 Flutter 应用程序，来说明如何使用它；

README.md：介绍包的文件；

CHANGELOG.md：记录每个版本中的更改；

LICENSE：包含软件包许可条款的文件。

image-20250311152157610

根目录文件

.gitignore：指定 Git 版本控制系统中需要忽略的文件和文件夹，避免将不必要的文件纳入版本控制。
LICENSE：项目的开源许可证文件，规定了项目代码的使用、修改和分发规则。
README.md：项目的说明文档，包含项目概述、插件信息和维护者信息。项目概述部分提到这是一个用于控制屏幕亮度的插件，并且实现了应用生命周期内设置和重置亮度的功能。同时还列出了各个平台插件的 Pub 链接，方便用户查看和使用。

子目录

screen_brightness_macos：包含 macOS 平台的插件代码和相关配置文件。其中 example 目录可能包含 macOS 平台的示例项目，macos 目录可能包含 macOS 原生代码和配置文件。
screen_brightness_android：包含 Android 平台的插件代码和相关配置文件。android 目录可能包含 Android 原生代码和配置文件，example 目录可能包含 Android 平台的示例项目。
screen_brightness_windows：包含 Windows 平台的插件代码和相关配置文件。
.idea：IntelliJ IDEA 或 Android Studio 的配置文件目录，包含 IDE 的项目设置、运行配置等信息。
.github：包含 GitHub 相关的配置文件和工作流。例如，可能包含用于自动化构建、测试和发布的 GitHub Actions 工作流配置文件。
screen_brightness_ios：包含 iOS 平台的插件代码和相关配置文件。
screen_brightness：主插件代码目录，可能包含跨平台的 Dart 代码和一些通用配置。
screen_brightness_platform_interface：包含跨平台接口定义的代码，为不同平台的插件提供统一的接口，方便实现多平台支持。

三、创建插件的 ohos 模块

命令：flutter create --platforms ohos,android,ios --org <org> <appName>

步骤：

1）用 VScode 打开刚刚下载好的插件；

2）打开 Terminal，cd 到插件目录下；

3）执行命令flutter create --platforms ohos screen_brightness_ohos 创建一个 ohos 平台的 flutter 模块。

执行创建命令前：

image-20250311152629432

执行创建命令后，可以将 screen_brightness_ohos 目录下的.dart_tool 和.ldea 文件删除。

image-20250311153328859

删除后

image-20250311153431552

四、编写 ohos 插件的 dart 接口和 pubspec.yaml 文件

可直接复制 screen_brightness_android 目录下 lib 的 dart 代码和 pubspec.yaml 文件进行修改；

android 目录

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_android
description: The Android federated plugin implementation of screen_brightness.
version: 2.1.1
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/

flutter:
  plugin:
    platforms:
      android:
        package: com.aaassseee.screen_brightness_android
        pluginClass: ScreenBrightnessAndroidPlugin

ohos 目录

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_ohos
description: "A new Flutter project."
# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

# The following defines the version and build number for your application.
# A version number is three numbers separated by dots, like 1.2.43
# followed by an optional build number separated by a +.
# Both the version and the builder number may be overridden in flutter
# build by specifying --build-name and --build-number, respectively.
# In Android, build-name is used as versionName while build-number used as versionCode.
# Read more about Android versioning at 
# In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion.
# Read more about iOS versioning at
# .html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 1.0.0+1

environment:
  sdk: '>=3.4.0 <4.0.0'

# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
  flutter:
    sdk: flutter


  # The following adds the Cupertino Icons font to your application.
  # Use with the CupertinoIcons class for iOS style icons.
  cupertino_icons: ^1.0.6

dev_dependencies:
  flutter_test:
    sdk: flutter

  # The "flutter_lints" package below contains a set of recommended lints to
  # encourage good coding practices. The lint set provided by the package is
  # activated in the `analysis_options.yaml` file located at the root of your
  # package. See that file for information about deactivating specific lint
  # rules and activating additional ones.
  flutter_lints: ^3.0.0

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter packages.
flutter:

  # The following line ensures that the Material Icons font is
  # included with your application, so that you can use the icons in
  # the material Icons class.
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware

  # For details regarding adding assets from package dependencies, see
  # /assets-and-images/#from-packages

  # To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see /custom-fonts/#from-packages

dart 代码基本不需要修改，只需要将 android 字样改为 ohos。

lib 目录 dart 代码：

image-20250311153908637

修改后的仅做参考

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_o ho s
description: The ohos federated plugin implementation of screen_brightness.
version: 2.1.1
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/

flutter:
  plugin:
    platforms:
      ohos:
        package: com.aaassseee.screen_brightness_ohos
        pluginClass: ScreenBrightnessohosPlugin

五、编写 ohos 插件的原生 ets 模块

1、创建 ohos 的插件模块

由于是写 ohos 平台的 flutter 插件，而不是写一个应用,需要将原来的 entry 模块删除，新建一个 path_provider 插件的静态模块，用来写 ets 原生代码逻辑。

步骤：

1）用 DevEco Studio 打开 screen_brightness_ohos 下的 ohos 项目：

image-20250311154231152

2）新建一个名称为 screen_brightness 的静态模块：

在 DevEco Studio 左上角点击Flie > New > Module > Static Library > Next ；

module name 填写为screen_brightness,其他选项为默认，点击 Finish，完成创建。

3）删除 entry 以及其他多余目录：

entry 目录（entry 是用来写应用的，现在是要写插件，此处已不需要，应该删除）；

image-20250311155825385

删除 entry

将screen_brightness > src > main > ets目录下的文件全部删除(此处是一些模板代码可删除)。

image-20250311155956165

2、修改相关配置文件

1）在 screen_brightness 目录内的 oh-package.json5 添加 libs/flutter.har 依赖：

代码语言：javascript代码运行次数：0运行复制

{
  "name": "screen_brightness",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "Index.ets",
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "@ohos/flutter_ohos": "file:libs/har/flutter.har"  //此处为添加的依赖
  }
}

2）将 screen_brightness 目录外侧的 oh-package.json5 的 dependencies 中的 flutter.har 依赖删除：

代码语言：javascript代码运行次数：0运行复制

/*
* Copyright (c) 2023 Hunan OpenValley Digital Industry Development Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     .0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

{
  "modelVersion": "5.0.0",
  "name": "screen_brightness_ohos",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {

  },
  "devDependencies": {
    "@ohos/hypium": "1.0.6"
  },
  "overrides": {

  }
}

3）在 screen_brightness 目录下添加 flutter.har：

image-20250311161026283

3、编写 ets 代码

文件结构，和代码逻辑可参考安卓或 ios：

ohos 的 api 可以参考：

4、修改 index 文件

代码语言：javascript代码运行次数：0运行复制

import {ScreenBrightnessPlugin} from './src/main/ets/flutter/plugins/screenbrightness/ScreenBrightnessPlugin'

export default ScreenBrightnessPlugin

5、打 har

写完代码，改完配置文件后，即可打 har 包：

打包工具：DevEco Studio

打包步骤：1、鼠标定位到 screen_brightness 目录；2、点击 DevEco Studio 中的 Build；3、点击 Make Module 'screen_brightness'选项；4、等待打包完成。

预期结果：

在screen_brightness > build > default > outputs中有 screen_brightness 生成，即为打 har 包成功。

六、编写 example

1、创建一个 ohos 平台的 flutter example 应用,用来验证刚刚适配的插件功能

cd 到 screen_brightness_ohos 目录下；

命令：flutter create --platforms ohos example

工具：Vscode

2、修改 dart 代码

复制screen_brightness_android\example\lib下的 main.dart 代码，替换screen_brightness_ohos\example\lib下的 main.dart 代码。

image-20250311163754260

3、修改 example pubspec.yaml 文件

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_android_example
description: Demonstrates how to use the screen_brightness_android plugin.

# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

environment:
  sdk: ">=3.0.0 <4.0.0"

# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
  flutter:
    sdk: flutter
  screen_brightness_ohos:
    path: ../
  screen_brightness_platform_interface:

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

dependency_overrides:
  screen_brightness_platform_interface:
    path: ../../screen_brightness_platform_interface/

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter.
flutter:

  # The following line ensures that the Material Icons font is
  # included with your application, so that you can use the icons in
  # the material Icons class.
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware.

  # For details regarding adding assets from package dependencies, see
  # /assets-and-images/#from-packages

  # To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see /custom-fonts/#from-packages

七、修改 screen_brightness 的 pubspec.yaml 文件

flutter: plugin:platforms 添加 ohos；

dependencies:添加 screen_brightness_ohos 依赖。

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness
description: A Plugin for controlling screen brightness with application life cycle reset implemented
version: 2.1.2
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"
  screen_brightness_android: ">=2.1.1 <3.0.0"
  screen_brightness_ios: ">=2.1.1 <3.0.0"
  screen_brightness_macos: ">=2.1.1 <3.0.0"
  screen_brightness_windows: ">=2.1.0 <3.0.0"
  screen_brightnes_ohos:
    path: ../screen_brightnes_ohos    #此处为添加

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"
  plugin_platform_interface: ">=2.0.0 <3.0.0"
  async: ">=2.0.0 <3.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/
#  screen_brightness_android:
#    path: ../screen_brightness_android
#  screen_brightness_ios:
#    path: ../screen_brightness_ios
#  screen_brightness_macos:
#    path: ../screen_brightness_macos
#  screen_brightness_windows:
#    path: ../screen_brightness_windows

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter.
flutter:
  # This section identifies this Flutter project as a plugin project.
  # The 'pluginClass' and Android 'package' identifiers should not ordinarily
  # be modified. They are used by the tooling to maintain consistency when
  # adding or updating assets for this project.
  plugin:
    platforms:
      android:
        default_package: screen_brightness_android
      ios:
        default_package: screen_brightness_ios
      macos:
        default_package: screen_brightness_macos
      windows:
        default_package: screen_brightness_windows
      ohos:
        default_package: screen_brightness_ohos   #此处为添加
  # To add assets to your plugin package, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg
  #
  # For details regarding assets in packages, see
  # /assets-and-images/#from-packages
  #
  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware.

  # To add custom fonts to your plugin package, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts in packages, see
  # /custom-fonts/#from-packages

八、运行 example

1、签名

用 Deveco Studio 打开三方库的 example > ohos 目录；

单击 File > Project Structure > Project > Signing Configs 界面勾选 Automatically generate signature，等待自动签名完成即可，单击 OK；

2、运行

cd 到path_provider_ohos\example > ohos目录，使用下列指令运行：

代码语言：javascript代码运行次数：0运行复制

flutter pub get
flutter run -d <device-id>

参考

ohos 平台适配 flutter 三方库指导[1]

[如何使用 Flutter 与 OpenHarmony 通信 FlutterChannel]( FlutterChannel.md "如何使用 Flutter 与 OpenHarmony 通信 FlutterChannel")

关于

作者：坚果派

公众号：nutpi

phone：17752170152 官网： /

参考资料

[1]

ohos 平台适配 flutter 三方库指导: .md

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。原始发表：2025-03-12，如有侵权请联系 cloudcommunity@tencent 删除开发者flutterfontsscreen插件

鸿蒙版 Flutter 三方库适配案例【screen

大家好，今天我们一起来实现一个鸿蒙版本的 screen_brightness

screen_brightness

简介

项目是一个用于控制屏幕亮度的 Flutter 插件项目，支持 Android、iOS、macOS 和 Windows 平台。

开发背景

screen_brightness

功能丰富：不仅可以获取和设置系统屏幕亮度，还能获取和设置应用内的屏幕亮度，并且可以重置应用内的屏幕亮度到系统默认值，功能较为全面。
无需额外权限控制应用亮度：控制应用内的屏幕亮度时不需要额外的权限，使用起来更加方便。
提供亮度变化监听：提供了系统和应用屏幕亮度变化的监听流，便于开发者实时获取屏幕亮度的变化情况，在需要根据亮度变化做出相应处理的场景下非常有用。
支持自动重置：具有自动重置应用内屏幕亮度的功能，可以通过设置自动将应用内的屏幕亮度重置为系统亮度，减少开发者手动管理的负担。
适用场景广泛：适用于需要对应用内屏幕亮度进行精细控制和管理的应用，比如阅读类应用、视频播放应用等，能够为用户提供更好的视觉体验。

screen

简洁易用：API 相对简洁，使用起来较为简单直接，对于只需要基本屏幕亮度控制功能的开发者来说，能够快速上手和集成。
同时支持屏幕保持唤醒：除了屏幕亮度控制外，还提供了屏幕保持唤醒的功能，方便在需要防止屏幕自动锁屏的场景下使用，如视频播放、游戏等应用。
适用场景广泛：适用于对屏幕状态控制有多种需求的应用，尤其是需要同时控制屏幕亮度和防止屏幕睡眠的应用，能够满足基本的屏幕管理需求。

总结

但是相比较来说，screen_brightness 目前一直在更新，所以我们今天就一起来看看如何对这个库进行适配。

一、准备工作

flutter 开发环境已配置：参考.md

下载待适配的三方插件：官方插件库地址/

目前 screen_brightness 在 github 上。

二、插件目录

lib：是对接 dart 端代码的入口，由此文件接收到参数后，通过 channel 将数据发送到原生端；

android：安卓端代码实现目录；

ios：ios 原生端实现目录；

example：一个依赖于该插件的 Flutter 应用程序，来说明如何使用它；

README.md：介绍包的文件；

CHANGELOG.md：记录每个版本中的更改；

LICENSE：包含软件包许可条款的文件。

image-20250311152157610

根目录文件

.gitignore：指定 Git 版本控制系统中需要忽略的文件和文件夹，避免将不必要的文件纳入版本控制。
LICENSE：项目的开源许可证文件，规定了项目代码的使用、修改和分发规则。
README.md：项目的说明文档，包含项目概述、插件信息和维护者信息。项目概述部分提到这是一个用于控制屏幕亮度的插件，并且实现了应用生命周期内设置和重置亮度的功能。同时还列出了各个平台插件的 Pub 链接，方便用户查看和使用。

子目录

screen_brightness_macos：包含 macOS 平台的插件代码和相关配置文件。其中 example 目录可能包含 macOS 平台的示例项目，macos 目录可能包含 macOS 原生代码和配置文件。
screen_brightness_android：包含 Android 平台的插件代码和相关配置文件。android 目录可能包含 Android 原生代码和配置文件，example 目录可能包含 Android 平台的示例项目。
screen_brightness_windows：包含 Windows 平台的插件代码和相关配置文件。
.idea：IntelliJ IDEA 或 Android Studio 的配置文件目录，包含 IDE 的项目设置、运行配置等信息。
.github：包含 GitHub 相关的配置文件和工作流。例如，可能包含用于自动化构建、测试和发布的 GitHub Actions 工作流配置文件。
screen_brightness_ios：包含 iOS 平台的插件代码和相关配置文件。
screen_brightness：主插件代码目录，可能包含跨平台的 Dart 代码和一些通用配置。
screen_brightness_platform_interface：包含跨平台接口定义的代码，为不同平台的插件提供统一的接口，方便实现多平台支持。

三、创建插件的 ohos 模块

命令：flutter create --platforms ohos,android,ios --org <org> <appName>

步骤：

1）用 VScode 打开刚刚下载好的插件；

2）打开 Terminal，cd 到插件目录下；

3）执行命令flutter create --platforms ohos screen_brightness_ohos 创建一个 ohos 平台的 flutter 模块。

执行创建命令前：

image-20250311152629432

执行创建命令后，可以将 screen_brightness_ohos 目录下的.dart_tool 和.ldea 文件删除。

image-20250311153328859

删除后

image-20250311153431552

四、编写 ohos 插件的 dart 接口和 pubspec.yaml 文件

可直接复制 screen_brightness_android 目录下 lib 的 dart 代码和 pubspec.yaml 文件进行修改；

android 目录

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_android
description: The Android federated plugin implementation of screen_brightness.
version: 2.1.1
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/

flutter:
  plugin:
    platforms:
      android:
        package: com.aaassseee.screen_brightness_android
        pluginClass: ScreenBrightnessAndroidPlugin

ohos 目录

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_ohos
description: "A new Flutter project."
# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

# The following defines the version and build number for your application.
# A version number is three numbers separated by dots, like 1.2.43
# followed by an optional build number separated by a +.
# Both the version and the builder number may be overridden in flutter
# build by specifying --build-name and --build-number, respectively.
# In Android, build-name is used as versionName while build-number used as versionCode.
# Read more about Android versioning at 
# In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion.
# Read more about iOS versioning at
# .html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 1.0.0+1

environment:
  sdk: '>=3.4.0 <4.0.0'

# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
  flutter:
    sdk: flutter


  # The following adds the Cupertino Icons font to your application.
  # Use with the CupertinoIcons class for iOS style icons.
  cupertino_icons: ^1.0.6

dev_dependencies:
  flutter_test:
    sdk: flutter

  # The "flutter_lints" package below contains a set of recommended lints to
  # encourage good coding practices. The lint set provided by the package is
  # activated in the `analysis_options.yaml` file located at the root of your
  # package. See that file for information about deactivating specific lint
  # rules and activating additional ones.
  flutter_lints: ^3.0.0

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter packages.
flutter:

  # The following line ensures that the Material Icons font is
  # included with your application, so that you can use the icons in
  # the material Icons class.
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware

  # For details regarding adding assets from package dependencies, see
  # /assets-and-images/#from-packages

  # To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see /custom-fonts/#from-packages

dart 代码基本不需要修改，只需要将 android 字样改为 ohos。

lib 目录 dart 代码：

image-20250311153908637

修改后的仅做参考

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_o ho s
description: The ohos federated plugin implementation of screen_brightness.
version: 2.1.1
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/

flutter:
  plugin:
    platforms:
      ohos:
        package: com.aaassseee.screen_brightness_ohos
        pluginClass: ScreenBrightnessohosPlugin

五、编写 ohos 插件的原生 ets 模块

1、创建 ohos 的插件模块

由于是写 ohos 平台的 flutter 插件，而不是写一个应用,需要将原来的 entry 模块删除，新建一个 path_provider 插件的静态模块，用来写 ets 原生代码逻辑。

步骤：

1）用 DevEco Studio 打开 screen_brightness_ohos 下的 ohos 项目：

image-20250311154231152

2）新建一个名称为 screen_brightness 的静态模块：

在 DevEco Studio 左上角点击Flie > New > Module > Static Library > Next ；

module name 填写为screen_brightness,其他选项为默认，点击 Finish，完成创建。

3）删除 entry 以及其他多余目录：

entry 目录（entry 是用来写应用的，现在是要写插件，此处已不需要，应该删除）；

image-20250311155825385

删除 entry

将screen_brightness > src > main > ets目录下的文件全部删除(此处是一些模板代码可删除)。

image-20250311155956165

2、修改相关配置文件

1）在 screen_brightness 目录内的 oh-package.json5 添加 libs/flutter.har 依赖：

代码语言：javascript代码运行次数：0运行复制

{
  "name": "screen_brightness",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "Index.ets",
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "@ohos/flutter_ohos": "file:libs/har/flutter.har"  //此处为添加的依赖
  }
}

2）将 screen_brightness 目录外侧的 oh-package.json5 的 dependencies 中的 flutter.har 依赖删除：

代码语言：javascript代码运行次数：0运行复制

/*
* Copyright (c) 2023 Hunan OpenValley Digital Industry Development Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     .0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

{
  "modelVersion": "5.0.0",
  "name": "screen_brightness_ohos",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {

  },
  "devDependencies": {
    "@ohos/hypium": "1.0.6"
  },
  "overrides": {

  }
}

3）在 screen_brightness 目录下添加 flutter.har：

image-20250311161026283

3、编写 ets 代码

文件结构，和代码逻辑可参考安卓或 ios：

ohos 的 api 可以参考：

4、修改 index 文件

代码语言：javascript代码运行次数：0运行复制

import {ScreenBrightnessPlugin} from './src/main/ets/flutter/plugins/screenbrightness/ScreenBrightnessPlugin'

export default ScreenBrightnessPlugin

5、打 har

写完代码，改完配置文件后，即可打 har 包：

打包工具：DevEco Studio

打包步骤：1、鼠标定位到 screen_brightness 目录；2、点击 DevEco Studio 中的 Build；3、点击 Make Module 'screen_brightness'选项；4、等待打包完成。

预期结果：

在screen_brightness > build > default > outputs中有 screen_brightness 生成，即为打 har 包成功。

六、编写 example

1、创建一个 ohos 平台的 flutter example 应用,用来验证刚刚适配的插件功能

cd 到 screen_brightness_ohos 目录下；

命令：flutter create --platforms ohos example

工具：Vscode

2、修改 dart 代码

复制screen_brightness_android\example\lib下的 main.dart 代码，替换screen_brightness_ohos\example\lib下的 main.dart 代码。

image-20250311163754260

3、修改 example pubspec.yaml 文件

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness_android_example
description: Demonstrates how to use the screen_brightness_android plugin.

# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

environment:
  sdk: ">=3.0.0 <4.0.0"

# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
  flutter:
    sdk: flutter
  screen_brightness_ohos:
    path: ../
  screen_brightness_platform_interface:

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"

dependency_overrides:
  screen_brightness_platform_interface:
    path: ../../screen_brightness_platform_interface/

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter.
flutter:

  # The following line ensures that the Material Icons font is
  # included with your application, so that you can use the icons in
  # the material Icons class.
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware.

  # For details regarding adding assets from package dependencies, see
  # /assets-and-images/#from-packages

  # To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see /custom-fonts/#from-packages

七、修改 screen_brightness 的 pubspec.yaml 文件

flutter: plugin:platforms 添加 ohos；

dependencies:添加 screen_brightness_ohos 依赖。

代码语言：javascript代码运行次数：0运行复制

name: screen_brightness
description: A Plugin for controlling screen brightness with application life cycle reset implemented
version: 2.1.2
homepage: 
repository: 
issue_tracker: 

topics:
  - screen
  - monitor
  - brightness

environment:
  sdk: ">=3.0.0 <4.0.0"
  flutter: ">=3.0.0"

dependencies:
  flutter:
    sdk: flutter
  screen_brightness_platform_interface: ">=2.1.0 <3.0.0"
  screen_brightness_android: ">=2.1.1 <3.0.0"
  screen_brightness_ios: ">=2.1.1 <3.0.0"
  screen_brightness_macos: ">=2.1.1 <3.0.0"
  screen_brightness_windows: ">=2.1.0 <3.0.0"
  screen_brightnes_ohos:
    path: ../screen_brightnes_ohos    #此处为添加

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ">=3.0.0 <4.0.0"
  plugin_platform_interface: ">=2.0.0 <3.0.0"
  async: ">=2.0.0 <3.0.0"

#dependency_overrides:
#  screen_brightness_platform_interface:
#    path: ../screen_brightness_platform_interface/
#  screen_brightness_android:
#    path: ../screen_brightness_android
#  screen_brightness_ios:
#    path: ../screen_brightness_ios
#  screen_brightness_macos:
#    path: ../screen_brightness_macos
#  screen_brightness_windows:
#    path: ../screen_brightness_windows

# For information on the generic Dart part of this file, see the
# following page: /tools/pub/pubspec

# The following section is specific to Flutter.
flutter:
  # This section identifies this Flutter project as a plugin project.
  # The 'pluginClass' and Android 'package' identifiers should not ordinarily
  # be modified. They are used by the tooling to maintain consistency when
  # adding or updating assets for this project.
  plugin:
    platforms:
      android:
        default_package: screen_brightness_android
      ios:
        default_package: screen_brightness_ios
      macos:
        default_package: screen_brightness_macos
      windows:
        default_package: screen_brightness_windows
      ohos:
        default_package: screen_brightness_ohos   #此处为添加
  # To add assets to your plugin package, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg
  #
  # For details regarding assets in packages, see
  # /assets-and-images/#from-packages
  #
  # An image asset can refer to one or more resolution-specific "variants", see
  # /assets-and-images/#resolution-aware.

  # To add custom fonts to your plugin package, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts in packages, see
  # /custom-fonts/#from-packages

八、运行 example

1、签名

用 Deveco Studio 打开三方库的 example > ohos 目录；

单击 File > Project Structure > Project > Signing Configs 界面勾选 Automatically generate signature，等待自动签名完成即可，单击 OK；

2、运行

cd 到path_provider_ohos\example > ohos目录，使用下列指令运行：

代码语言：javascript代码运行次数：0运行复制

flutter pub get
flutter run -d <device-id>

参考

ohos 平台适配 flutter 三方库指导[1]

[如何使用 Flutter 与 OpenHarmony 通信 FlutterChannel]( FlutterChannel.md "如何使用 Flutter 与 OpenHarmony 通信 FlutterChannel")

关于

作者：坚果派

公众号：nutpi

phone：17752170152 官网： /

参考资料

[1]

ohos 平台适配 flutter 三方库指导: .md

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。原始发表：2025-03-12，如有侵权请联系 cloudcommunity@tencent 删除开发者flutterfontsscreen插件

本文标签：鸿蒙版 Flutter 三方库适配案例screen

版权声明：本文标题：鸿蒙版 Flutter 三方库适配案例【screen 内容由热心网友自发贡献，该文观点仅代表作者本人，转载请联系作者并注明出处：http://it.en369.cn/jiaocheng/1748332816a2286844.html，本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。

369IT编程

鸿蒙版 Flutter 三方库适配案例【screen

鸿蒙版 Flutter 三方库适配案例【screen

screen_brightness

简介

开发背景

screen_brightness

screen

总结

一、准备工作

二、插件目录

根目录文件

子目录

三、创建插件的 ohos 模块

四、编写 ohos 插件的 dart 接口和 pubspec.yaml 文件

android 目录

ohos 目录

五、编写 ohos 插件的原生 ets 模块

1、创建 ohos 的插件模块

2、修改相关配置文件

3、编写 ets 代码

4、修改 index 文件

5、打 har

六、编写 example

1、创建一个 ohos 平台的 flutter example 应用,用来验证刚刚适配的插件功能

2、修改 dart 代码

3、修改 example pubspec.yaml 文件

七、修改 screen_brightness 的 pubspec.yaml 文件

八、运行 example

1、签名

2、运行

参考

关于

鸿蒙版 Flutter 三方库适配案例【screen

screen_brightness

简介

开发背景

screen_brightness

screen

总结

一、准备工作

二、插件目录

根目录文件

子目录

三、创建插件的 ohos 模块

四、编写 ohos 插件的 dart 接口和 pubspec.yaml 文件

android 目录

ohos 目录

五、编写 ohos 插件的原生 ets 模块

1、创建 ohos 的插件模块

2、修改相关配置文件

3、编写 ets 代码

4、修改 index 文件

5、打 har

六、编写 example

1、创建一个 ohos 平台的 flutter example 应用,用来验证刚刚适配的插件功能

2、修改 dart 代码

3、修改 example pubspec.yaml 文件

七、修改 screen_brightness 的 pubspec.yaml 文件

八、运行 example

1、签名

2、运行

参考

关于

更多相关文章

鸿蒙版 Flutter 三方库适配案例【screen

发表评论

推荐文章

强化学习微调（ReFT）来了，AI不再只是“记住答案”！

贵的和便宜的MCU仿真器差异在哪里？

[MYSQL] query

如何快速定位Java生产环境中的问题

AI口语机器人的功能规划

热门文章

php怎么获取不带后缀的文件名?

开源协议不能随便选！选错直接被「背刺」

C# 深度学习：对抗生成网络(GAN)训练头像生成模型

掌握文件权限：理解Linux chmod

AI时代的新组织架构：合馈制

AD5940序列器

For a menu custom link (without a link) a "#" is appended. Can this just be blank, i.e. NO link?

multisite - Hook into 'admin_url' but only on Mysites admin bar menu