Flutter宗教方向指引插件flutter_qiblah_update的使用

Flutter Qiblah

flutter_qiblah 插件用于在Flutter应用中获取朝向克尔白天房（Qiblah）的方向。该插件支持设备传感器（仅限Android），并提供了获取北向方向、Qiblah方向以及与北向的偏移量等功能。

开始使用

要开始使用此插件，请将 flutter_qiblah 添加到你的 pubspec.yaml 文件中：

dependencies:
  flutter_qiblah: '<latest_release>'

然后运行 flutter pub get 来安装依赖。

特性

• 检查设备传感器支持（仅限Android）
• 请求位置权限
• 检查GPS状态（启用和权限状态）
• 接收Qiblah方向、北向方向及Qiblah与北向的偏移量

屏幕

以下是示例应用的演示：

基于 LocationStatus 类，你可以添加一个检查来查看当前的GPS状态，并在禁用或权限被拒绝时显示错误小部件。请参阅 示例代码。

对于没有传感器的设备，可以显示一张地图，展示从当前位置到麦加的方向。请参阅 示例代码。

问题

请在我们的 GitHub 页面上提交任何问题、错误报告或功能请求。

贡献

如果您希望为插件做出贡献（例如改进文档、修复错误或添加新功能），请仔细阅读我们的贡献指南并发送您的 拉取请求。

完整示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_qiblah 插件来获取并显示Qiblah方向。

import 'package:flutter/material.dart';
import 'package:flutter_qiblah/flutter_qiblah.dart';
import 'package:flutter_qiblah_example/loading_indicator.dart';
import 'package:flutter_qiblah_example/qiblah_compass.dart';
import 'package:flutter_qiblah_example/qiblah_maps.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  // 获取设备是否支持传感器
  final _deviceSupport = FlutterQiblah.androidDeviceSensorSupport();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        primaryColor: Color(0xff0c7b93),
        primaryColorLight: Color(0xff00a8cc),
        primaryColorDark: Color(0xff27496d),
        accentColor: Color(0xffecce6d),
      ),
      darkTheme: ThemeData.dark().copyWith(accentColor: Color(0xffecce6d)),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: FutureBuilder(
          future: _deviceSupport,
          builder: (_, AsyncSnapshot<bool?> snapshot) {
            // 等待传感器支持信息加载完成
            if (snapshot.connectionState == ConnectionState.waiting)
              return LoadingIndicator();
            // 如果加载失败，显示错误信息
            if (snapshot.hasError)
              return Center(
                child: Text("Error: ${snapshot.error.toString()}"),
              );

            // 如果设备支持传感器，显示指南针
            if (snapshot.data!)
              return QiblahCompass();
            // 否则显示地图
            else
              return QiblahMaps();
          },
        ),
      ),
    );
  }
}

加载指示器（Loading Indicator）

// 加载指示器组件
class LoadingIndicator extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: CircularProgressIndicator(),
    );
  }
}

指南针组件（Qiblah Compass）

// 指南针组件
class QiblahCompass extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      child: Text('指南针组件未实现'),
    );
  }
}

地图组件（Qiblah Maps）

// 地图组件
class QiblahMaps extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      child: Text('地图组件未实现'),
    );
  }
}