安装指南

Flutter SDK 集成指南

下载和导入

下载中心 中下载flutter sdk压缩文件,解压到本地,然后修改pubspec.yaml文件

例如解压后 文档结构为:

|-- Your Flutter Project
|-- fission << SDK解压目录

修改pubspec.yaml文件:

dependencies:
  flutter:
    sdk: flutter
  fission:
    path: ../fission  # 此处相对路径根据您的本地文档结构调整

保存后,运行flutter packages get 检查是否导入成功

初始化

  • Android应用build.gradle(android/app/) 配置minSdkVersion
defaultConfig {
  minSdkVersion 18
  ...

在main.dart文件中初始化

appKey在开发者平台“发布应用”中获得,具体见接入指南

import 'package:fission/fission.dart'; // << add this line

void main() {
  FissionInstall.init(appKey); // << add this line
  runApp(MyApp());
}

功能集成

  • 获取分享链接

    • 参数

      packageName: String 需分享的应用的包名,如不传则默认为当前应用包名 params: Map 分享链接所携带的安装参数

    String _packageName = 'com.app';
    // 组装安装参数,例如当前用户ID、用户名、游戏ID等
    Map<String, dynamic> _p = {'uid': 3455, 'uname': 'sophie'};
    String url = await FissionInstall.getFissionUrl(packageName: _packageName, params:_p);
    
  • 获取安装参数

    此功能能够匹配当前安装设备的来源数据(即"获取分享链接"功能中所组装的安装参数)

    注意:确保以下两点以正确获取到安装参数:

    1. 手机通过分享链接下载安装应用;
    2. 在下载后24h内调用此接口。
    Map<String, dynamic> _data = await FissionInstall.getInstallParams();
    

    开发者可根据安装参数做下一步处理使用,如获得当前设备的上线用户,分享奖励,根据游戏ID跳转界面等

  • 清除安装参数(调试用)

    调用getInstallParams 之后获取的安装参数将存储在本地,此后再次调用时读取本地数据。

    调试时可调用此接口清除本地数据:

    await FissionInstall.clearMatchData();
    
  • 生成二维码

    生成文本内容对应的二维码图片, 可指定大小

    var img = FissionUtil.makeQrImage("Content", 200.0); // create 200px*200px image
    Container(
      padding: EdgeInsets.all(10.0),
      color: Colors.yellow,
      child: img,
    );
    
  • 社会化分享

    暂时支持微信分享(微信会话、朋友圈、微信收藏)

    注:开发者可根据需求选择使用此功能,或自行开发分享功能。此功能根据fluwx 开发

    1. 准备工作

      申请微信应用ID,请至 微信开放平台 管理中心 创建应用,应用审核通过(一般一周以内)之后获得AppId

      • IOS平台 UrlScheme设置,修改info.plist 增加以下内容

        <key>LSApplicationQueriesSchemes</key>
        <array>
          <!-- 微信 URL Scheme 白名单-->
          <string>wechat</string>
          <string>weixin</string>
        </array>
        <key>CFBundleURLTypes</key>
        <array>
          <dict>
            <key>CFBundleTypeRole</key>
            <string>Editor</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>微信开放平台中应用的AppId,以wx开头的字符串</string>
            </array>
          </dict>
        </array>
        
    2. 注册应用

      fluwx.register(appId:"微信开放平台中申请的应用AppId");
      
    3. 分享方法

      分享场景参数说明:

      WxShareScene.session 微信会话

      WxShareScene.timeline 朋友圈

      WxShareScene.favorite 微信收藏

      • 分享文字

        WxShareScene scene = WxShareScene.session;
        FissionUtil.wxShareWebpage(
                text: 'Your Title',
                scene: scene);
        
      • 分享网页

        WxShareScene scene = WxShareScene.session;
        FissionUtil.wxShareWebpage(
                title: 'Your Title',
                description: 'Text Description',
                scene: scene,
                url: 'Url String');
        
      • 分享图片

        WxShareScene scene = WxShareScene.session;
        FissionUtil.wxShareImage(
                imagePath: 'https://www.baidu.com/img/bd_logo1.png',
                scene: scene);
        

results matching ""

    No results matching ""