Flutter应用分享插件share_apps的使用

通过朋友之间的推荐将您的应用展示给每个人。以非常微妙和简单的方式实现点对点邀请。

开始使用

这个项目是一个 Dart 包， 一个库模块，包含可以在多个 Flutter 或 Dart 项目中轻松共享的代码。

要开始使用 Share 应用，请查看我们的 在线文档，该文档提供了教程、示例、有关 SDK 集成的指导以及完整的 API 参考。

安装

在 pubspec.yaml 文件中添加依赖：

dependencies:
  ...
  share_apps: ^0.2.10

权限

Android

在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.READ_CONTACTS" />  
<uses-permission android:name="android.permission.WRITE_CONTACTS" />

iOS

在 Info.plist 文件中设置 NSContactsUsageDescription：

<key>NSContactsUsageDescription</key>
<string>此应用需要联系人访问权限才能正常运行。</string>

如何使用

导入 share_apps 包：

import 'package:share_apps/share_apps.dart';

示例

步骤 1

在 main.dart 文件中初始化 ShareApps，传入 appId、secreteKey 和注册的电子邮件地址。

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

void main() {
  ShareApps.init(
    appId: 'XXXXXXXXXXXXXXXXXXX', // (AppId from) royalty.shareapps.net
    secreteKey: 'XXXXXXXXXXXXXX', // (secreteKey from) royalty.shareapps.net
    email: 'XXX@XXX.com', // (Email Address which registered in) royalty.shareapps.net (它需要用于电子邮件邀请)
    app_name: 'XXXXXX', // (输入你集成 ShareApp SDK 的应用名)
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: MyHomePage(),
    );
  }
}

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Share App Demo'),
      ),
      body: Center(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.center,
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            MaterialButton(
              child: Text('Invite Friends'),
              onPressed: () {
                ShareApps.sendInvitation(context: context);
              },
            ),
            MaterialButton(
              child: Text('Invite Friends Background'),
              onPressed: () {
                ShareApps.sendInvitationInBackground(
                  context: context,
                  firstName: 'XXXX', // 用户名字
                  lastName: 'XXXX', // 用户姓氏
                  email: 'XXX@XXX.com', // 用户电子邮件地址
                  countryCode: 'US', // 用户国家
                  language: 'English', // 用户语言
                  number: '+1000000000', // 用户手机号码（带国家代码）
                );
              },
            ),
          ],
        ),
      ),
    );
  }
}

注意事项

• 使用有效的手机号码，并包含国家代码。
• 使用有效的电子邮件地址。

更多详情请看示例

sendInvitation()

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Share App Demo'),
      ),
      body: Center(
        child: RaisedButton(
          child: Text('Invite Friends'),
          onPressed: () {
            ShareApps.sendInvitation(context: context);
          },
        ),
      ),
    );
  }
}

sendInvitationInBackground()

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Share App Demo'),
      ),
      body: Center(
        child: RaisedButton(
          child: Text('Invite Friends in Background'),
          onPressed: () {
            ShareApps.sendInvitationInBackground(
              context: context,
              firstName: 'XXXX', // 用户名字
              lastName: 'XXXX', // 用户姓氏
              email: 'XXX@XXX.com', // 用户电子邮件地址
              countryCode: 'US', // 用户国家
              language: 'English', // 用户语言
              number: '+1000000000', // 用户手机号码（带国家代码）
            );
          },
        ),
      ),
    );
  }
}