Flutter集成服务插件farly_flutter_sdk的使用

Farly SDK for Flutter

安装

此Flutter插件发布在 pub.dev。

有关安装说明，请参阅 pub.dev。

使用

完整的文档可以在 此处 访问。

你也可以检查 example 文件夹中的示例应用。

开发插件

开发

从vscode中打开 example/main.dart 并选择 Run > Start Debugging 来启动示例应用。你可以选择屏幕右下角的设备。（你需要安装flutter扩展）。

发布

首先，在 pubspec.yaml 和 ios/farly_flutter_sdk.podspec 中更新版本号。 别忘了填写 CHANGELOG.md 文件。

然后运行以下命令（你需要登录到 pub.dev）：

flutter pub publish --dry-run # 检查一切是否正常
flutter pub publish # 发布新版本

许可证

MIT

示例代码

以下是示例代码，位于 这里。

import 'dart:io';

import 'package:farly_flutter_sdk/feed_element.dart';
import 'package:farly_flutter_sdk/offerwall_request.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:farly_flutter_sdk/farly_flutter_sdk.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  List<FeedElement> _feedElements = [];
  final _farlyFlutterSdkPlugin = FarlyFlutterSdk();
  final _req = OfferWallRequest(
    userId: 'userId',
    userSignupDate: DateTime.now(),
    userGender: UserGender.male,
  );

  [@override](/user/override)
  void initState() {
    super.initState();
    _farlyFlutterSdkPlugin.setup(publisherId: 'publisherId');
    if (Platform.isIOS) {
      _farlyFlutterSdkPlugin.requestAdvertisingIdAuthorization();
    }
    refreshOffers();
  }

  // 平台消息异步发送，因此我们在异步方法中初始化
  Future<void> refreshOffers() async {
    setState(() {
      _feedElements = [];
    });
    var feedElements = await _farlyFlutterSdkPlugin.getOfferwall(_req);

    // 如果小部件在异步平台消息飞行时已从树中移除，我们希望丢弃回复而不是调用
    // setState来更新我们的不存在的外观。
    if (!mounted) return;

    setState(() {
      _feedElements = feedElements;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () {
                  _farlyFlutterSdkPlugin.showOfferwallInBrowser(_req);
                },
                child: const Text('在浏览器中显示offer墙'),
              ),
              ElevatedButton(
                onPressed: () {
                  _farlyFlutterSdkPlugin.showOfferwallInWebview(_req);
                },
                child: const Text('在webview中显示offer墙'),
              ),
              ElevatedButton(
                onPressed: () {
                  _farlyFlutterSdkPlugin
                      .getHostedOfferwallUrl(_req)
                      .then((value) {
                    Clipboard.setData(ClipboardData(text: value ?? ''));
                    print("已复制到剪贴板");
                    print(value);
                  });
                },
                child: const Text('将offer墙url复制到剪贴板'),
              ),
              ElevatedButton(
                onPressed: () {
                  refreshOffers();
                },
                child: const Text('刷新offers数组'),
              ),
              Expanded(
                child: ListView.builder(
                  itemCount: _feedElements.length,
                  itemBuilder: (context, index) {
                    final feedElement = _feedElements[index];
                    return ListTile(
                      title: Text(feedElement.name),
                      subtitle: Text(feedElement.smallDescription ?? ''),
                    );
                  },
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}