README_CN.md

Fluwx

---

什么是Fluwx

Fluwx 是一个微信SDK插件，它允许开发者调用 微信原生SDK.

加入我们的QQ群: 1003811176

能力

• 分享图片，文本，音乐，视频等。支持分享到会话，朋友圈以及收藏.
• 微信支付.
• 在微信登录时，获取Auth Code.
• 拉起小程序.
• 订阅消息.
• 打开微信.
• 从微信标签打开应用

准备

迁移到V4指南

破坏性更新 ：从4.5.0起，当分享图片到微信时，如果不支持FileProvider方式分享，Fluwx不再尝试申请WRITE_EXTERNAL_STORAGE权限，这意味着你需要自己处理权限问题。

Fluwx 可以做很多工作但不是所有. 在集成之前，最好读一下官方文档.
然后你才知道怎么生成签名，怎么使用universal link以及怎么添加URL schema等.

安装

在pubspec.yaml 文件中添加fluwx依赖:

Fluwx，带支付:

dependencies:
  fluwx: ^${latestVersion}

不带支付的Fluwx:

一些开发者并不需要在iOS端使用支付能力，此时您可以通过在pubspec.yaml. 中开启no_pay。

NOTE: 别忘记替换 ^${latestVersion} ！！！！

配置

Fluwx 从v4开始可以在pubspec.yaml的fluwx进行一些配置。具体可以参考pubspec.yaml。

V4开始，iOS中的url_scheme，universal_link, LSApplicationQueriesSchemes可以不必开发者手动配动。只需在pubspec.yaml 中填写即可。

• app_id. 推荐. 它将用于生成iOS的url_scheme。这并不会替你初始化微信SDK，所以你还是自己调用fluwx.registerApi。

• debug_logging. 可选. 把它设置成true可以开启日志。

• flutter_activity. 可选. 这个通常是用于Android的冷启动。如果不设置任何值，Fluwx将尝试启动launcher activity.

• universal_link. iOS 推荐. 它将用自动配置universal_link。

• scene_delegate. iOS 可选. 使用 AppDelegate 还是使用 SceneDelegate. 查阅官方文档了解更多.

• For iOS 如果你在iOS上遇到了 cannot load such file -- plist, 请按照以下步骤进行操作：

# step.1 安装必要依赖
sudo gem install plist
# step.2 进行iOS文件夹(example/ios/,ios/)
cd example/ios/
# step.3 执行脚本
pod install

• 在 OpenHarmony 上，要检查微信是否已安装，请在项目的 module.json5 中添加以下内容

{
  "module": {
    "querySchemes": [
      "weixin"
    ],
  }
}

注册 WxAPI

通过 fluwx 注册WxApi.

Fluwx fluwx = Fluwx();
fluwx.registerApi(appId: "wxd930ea5d5a228f5f",universalLink: "https://your.univerallink.com/link/");

参数 universalLink 只在iOS上有用. 查看文档 以便了解如何生成通用链接.
你也可以学习到怎么在iOS工程中添加URL schema，怎么添加LSApplicationQueriesSchemes。这很重要。

对于Android, 可以查看本文以便了解怎么获取app签名. 然后你需要知道release和debug时，app签名有什么区别。如果签名不对，你会得一个错误 errCode = -1.

建议越早注册越好。

能力文档

• 基础知识
• 分享
• 支付
• 登录
• 从微信标签打开应用 对于更多功能，可以查看源码。

QA

这些问题可能对你有帮助

捐助

开源不易，请作者喝杯咖啡。

关注公众号

关注趋势

LICENSE

Copyright 2018 OpenFlutter Project

Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements.  See the NOTICE file distributed with this work for
additional information regarding copyright ownership.  The ASF licenses this
file to you under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License.  You may obtain a copy of
the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
License for the specific language governing permissions and limitations under
the License.