Fluwx:微信SDK在Flutter上的實現

jarvanmo發表於2018-08-19
Flutter

前言

隨著 Flutter越來越火熱，我相信越來越多的小夥伴都躍躍欲試。但是一個很重要的問題是，很多第三方
SDK，如微信SDK，都無法在Flutter上直接使用。所以，我這幾天開發了一個微信SDK的外掛，希望能夠一定程度上幫助到大家。

Fluwx要做什麼

  • 分享
  • 登入
  • 支付

這是Fluwx的目標。現在Fluwx仍在開發階段，android分享部分已經完成，ios部分還在持續開發。如果你想也成為Fluwx的開發者，可以給我留言。

需要準備的

使用Fluwx之前，強烈建議先閱讀微信SDK官方文件，
這有助於你使用Fluwx。Fluwx的api欄位名稱基本和官方的欄位名稱是一致的。

引入

在pubspec.yaml檔案中新增如下程式碼：

dependencies:
  fluwx: ^0.0.1

初始化

Fluwx.registerApp(RegisterModel(appId: "your app id", doOnAndroid: true, doOnIOS: true));
  • appId：在微信平臺申請的appId。
  • doOnAndroid:是否在android平臺上執行此操作。
  • doOnIOS:是否在平臺上執行此操作。
    每一個欄位都是非必須的，但是如果不傳appId或doOnAndroid: false或者doOnIOS: false，請務必在對應平臺手動註冊WXApi，以保證
    Fluwx正常工作。
    註冊完成後，請在對應平臺新增如下程式碼：
    在Android上：
FluwxShareHandler.setWXApi(wxapi)

在iOS上：

isWeChatRegistered = YES;

你也可以取消註冊你的app。

Fluwx.unregisterApp(RegisterModel(doOnAndroid: true, doOnIOS: true));

注意：儘管可以通過Fluwx完成微信註冊，但一些操作依然需要在對應平臺進行設定，如配置iOS的URLSchema等。

開始分享

以分享文字和網址為例：

  var fluwx = Fluwx();
  fluwx.share(WeChatShareImageModel(image: "imagePath",thumbnail: "thumbanailPath"));
  fluwx.share(
              WeChatShareWebPageModel(
              webPage: "https://github.com/JarvanMo/fluwx",
              title: "Fluwx",
              thumbnail: "http://d.hiphotos.baidu.com/image/h%3D300/sign=1057e22c6ed9f2d33f1122ef99ee8a53/3bf33a87e950352aadfff8c55f43fbf2b3118b65.jpg",
              )).then((result){
               },
               onError: (msg){
               });

fluwx.share(WeChatShareModel)目前僅支援系統內WeChatShareModel的子類，不支援自定義。
所有欄位名字和官方文件基本是一致的。

圖片處理

圖片僅支援png和jpg。
目前所有需要圖片的地方支援網路圖片及assets圖片。</br>
使用assets圖片需要新增assets://。</br>
也可以在assets圖片新增?package=package_name以讀取指定包的圖片。</br>
未來可能支援file://。</br>
如果不指定schema或者schema錯誤,將會被處理為網路圖片，請謹慎。</br>

注意

所有涉及縮略的最好給Fluwx一個合格的圖片（小於32k,小程式小於120k），否則Fluwx將會對圖片進行處理，這樣做的結果可能並不是你所預期的，如縮圖被裁剪。
專案傳送門


相關文章