Flutter华为HMS可用性检测插件huawei_hmsavailability的使用

Flutter华为HMS可用性检测插件huawei_hmsavailability的使用

简介

HUAWEI HMS可用性检测插件允许你检测设备上是否安装了HMS Core APK。如果HMS Core未安装，你可以使用插件提供的API通知用户并请求安装。该插件提供了HUAWEI BASE SDK下的HmsApiAvailability模块的功能。

安装

请访问pub.dev查看详细的安装说明。

文档

• 快速开始
• 参考文档

常见问题或遇到问题时

如果你在使用HMS样本时遇到任何问题，请尝试以下选项：

• 在Stack Overflow上提问，并确保你的问题标签为huawei-mobile-services。
• 在Github上提交一个issue或提出建议。
• 在Huawei Developer Forum上提问，这是一个获取一般问题帮助的好地方。
• 查阅Huawei Developer Docs，这是所有HMS Core套件的官方文档。

如果你在我们的样本中发现了bug，请提交到Github仓库。

许可证

HUAWEI HMS可用性检测插件遵循Apache 2.0许可证。

完整示例代码

/*
    Copyright 2021-2024. Huawei Technologies Co., Ltd. All rights reserved.

    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

        https://www.apache.org/licenses/LICENSE-2.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.
*/

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:huawei_hmsavailability/huawei_hmsavailability.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: HmsAvailabilityDemo(),
    );
  }
}

class HmsAvailabilityDemo extends StatefulWidget {
  const HmsAvailabilityDemo({Key? key}) : super(key: key);

  [@override](/user/override)
  State<HmsAvailabilityDemo> createState() => _HmsAvailabilityDemoState();
}

class _HmsAvailabilityDemoState extends State<HmsAvailabilityDemo> {
  late HmsApiAvailability hmsApiAvailability;
  String _result = 'HMS可用性结果码: 未知';
  final List<String> _eventList = ['可用性事件列表将显示在这里'];

  [@override](/user/override)
  void initState() {
    super.initState();
    hmsApiAvailability = HmsApiAvailability();
  }

  [@override](/user/override)
  void dispose() {
    hmsApiAvailability.destroyStreams();
    super.dispose();
  }

  void _getAvailability() async {
    try {
      // 检测HMS Core的可用性，并返回结果码
      final int resultCode = await hmsApiAvailability.isHMSAvailableWithApkVersion(28);
      setState(() {
        _result = 'HMS可用性结果码: $resultCode';
      });

      // 如果结果码不为0，则表示HMS Core不可用，弹出错误对话框
      if (resultCode != 0) {
        // 设置结果监听器
        hmsApiAvailability.setResultListener = (AvailabilityEvent? event) {
          if (event != null) {
            setState(() {
              _eventList.add('可用性事件: ${describeEnum(event)}');
            });
          }
        };
        // 弹出错误对话框，请求用户安装HMS Core
        hmsApiAvailability.getErrorDialog(resultCode, 1000, true);
      }
    } catch (e) {
      // 捕获异常并添加到事件列表
      setState(() {
        _eventList.add('$e');
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('HMS可用性演示'),
      ),
      body: SafeArea(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            const SizedBox(height: 30),
            Text(_result),
            Padding(
              padding: const EdgeInsets.symmetric(vertical: 8),
              child: ElevatedButton(
                style: ElevatedButton.styleFrom(
                  backgroundColor: const Color(0xff394867),
                  foregroundColor: Colors.white,
                ),
                onPressed: _getAvailability,
                child: const Text('检查HMS Core可用性'),
              ),
            ),
            const Divider(color: Colors.black),
            Expanded(
              child: Padding(
                padding: const EdgeInsets.symmetric(vertical: 8),
                child: ListView.builder(
                  itemCount: _eventList.length,
                  itemBuilder: (BuildContext context, int index) {
                    return Center(
                      child: Padding(
                        padding: const EdgeInsets.only(bottom: 5),
                        child: Text(
                          _eventList[index],
                          style: TextStyle(
                            fontWeight: index == 0
                                ? FontWeight.bold
                                : FontWeight.normal,
                          ),
                        ),
                      ),
                    );
                  },
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}