安装指南
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);
获取安装参数
此功能能够匹配当前安装设备的来源数据(即"获取分享链接"功能中所组装的安装参数)
注意:确保以下两点以正确获取到安装参数:
- 手机通过分享链接下载安装应用;
- 在下载后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 开发
准备工作
申请微信应用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>
注册应用
fluwx.register(appId:"微信开放平台中申请的应用AppId");
分享方法
分享场景参数说明:
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);