Flutter集成Appsonair服务插件appsonair_flutter_sdk的使用

Flutter集成Appsonair服务插件appsonair_flutter_sdk的使用

安装

在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  appsonair_flutter_sdk: ^0.2.2

然后在 Dart 文件中导入插件：

import 'package:appsonair_flutter_sdk/apps_on_air_service.dart';

集成

首先，在初始化 MaterialApp 之后调用以下代码。如果要使用默认（原生）UI，则将 showNativeUI 设置为 true；如果要使用自定义 UI，则将其设置为 false。

void main() async {
  AppsOnAir.setAppId('*********-e640-477c-aa48-***********', showNativeUI: true); ///appId From https://appsonair.com/
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

如果要使用默认（原生）UI，可以这样调用：

AppsOnAir.checkForAppUpdate(
  context,
);

如果要使用自定义 UI，则可以这样调用：

AppsOnAir.checkForAppUpdate(
  context,
  customWidget: (response) {
    /// 返回你的自定义小部件
    return Container();
  },
);

使用

要使用此插件，请参阅核心使用文档。

应用更新模式（Android / iOS）

该功能允许你直接通过AoA配置应用的版本更新。

如果要在Android/iOS上向用户显示应用更新对话框，需要执行以下步骤：

1. 转到应用详情页面，从应用仪表板。
2. 在应用详情页面，转到应用服务标签，然后转到更新标签。
3. 使用开关启用Android和/或iOS的更新，并填写所需信息。
4. 设置详细信息：
   • 默认模式是软更新，用户会收到任何可用更新的通知，并可以选择更新或跳过。
   • 如果启用了强制更新模式，用户将收到可用更新的通知，并必须强制安装更新。
   • 最低构建版本：如果安装的应用版本低于AOA仪表板中提到的最低构建版本，则用户将收到应用更新对话框。
   • 商店链接：如果用户点击更新按钮，它将重定向用户到相关的商店链接。

更多细节请访问Android/iOS更新模式文档。

维护模式

如果项目需要进入维护模式以修复部署问题、错误修复或项目升级，AoA维护模式将帮助你。以下是配置应用维护模式的方法：

1. 进入你要配置维护模式的应用。
2. 在应用详情页面，转到应用服务标签，然后转到维护模式标签。
3. 使用开关启用此模式。
4. 启用后，填写必要信息并点击保存按钮。此时应用已进入维护模式。
5. 如果用户打开应用，它将显示一个维护屏幕，不会让用户使用任何移动应用功能。

更多细节请访问维护模式文档。

问题与反馈

如需报告FlutterFire相关的问题、错误或功能请求，请在我们的问题跟踪器中提交。

示例代码

以下是完整的示例代码：

import 'package:appsonair_flutter_sdk/apps_on_air_service.dart';
import 'package:flutter/material.dart';

void main() async {
  AppsOnAir.setAppId('*********-e640-477c-aa48-***********', showNativeUI: true);
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: const DemoApp(),
      ),
    );
  }
}

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

  [@override](/user/override)
  State<DemoApp> createState() => _DemoAppState();
}

class _DemoAppState extends State<DemoApp> {
  [@override](/user/override)
  void initState() {
    AppsOnAir.checkForAppUpdate(
      context,

      /// 使用自定义小部件只有在你想使用自定义UI时，确保传递 `showNativeUI` 参数为 `false`
      customWidget: (response) {
        return Column(children: [
          Text("应用程序名称 : ${response["appName"]}"),
          Text(
            "应用程序版本 : ${response["updateData"]["androidBuildNumber"]}",
          ),
          MaterialButton(
            onPressed: () {},
          )
        ]);
      },
    );
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Container(),
    );
  }
}