Skip to content

Latest commit

 

History

History
186 lines (133 loc) · 11.1 KB

QA_CN.md

File metadata and controls

186 lines (133 loc) · 11.1 KB

!!!!请先看文档,再看常见Q&A,再查看issue,自我排查错误,方便你我他。依然无法解决的问题可以加群提问, QQ Group:892398530。!!!!

常见Q&A

无法拉起微信
安卓端编译失败
无法调起支付
安卓端编译报错AndroidX相关
WeChat Not Installed on iOS?
没有安装微信,微信登录不了,导致iOS审核失败
Failed to notify project evalution listener
isWeChatInstalled返回false
Kotlin报错:XXX is only available since Kotlin x.xx and cannot be used in Kotlin x.xx
listen监听多次调用
分享完成或者取消分享后App崩溃
IOS编译错误:No such module 'fluwx'
支付成功后,按物理按键或手机自动返回商户APP,监听不到返回数据
iOS报错:Specs satisfying the fluwx (from .symlinks/plugins/fluwx/ios) dependency were found, but they required a higher minimum deployment target.
ResponseType与Dio插件中的命名冲突
ShareSDK(分享插件)和Fluwx(微信支付插件)存在冲突
图片加载失败?
iOS registerWxApi 返回 -1
分享后,打开微信出现未审核应用
分享怎样知道是成功分享了还是取消了没有分享
运行时报错kotlinx相关
android手机在拉起微信前会弹出选择微信分身页面
android代码混淆

无法拉起微信?

  1. Android 端:
    • 请检查 AppId、App签名是否和微信开放平台中填写的一致。
    • debug 和 release 的签名默认不一样,请注意。注意签名规则:issue 89 ,keystore工具生成的MD5需要去除横杆并且全部转换为小写,然后配置到 build.gradle
  2. iOS 端:
    • 检查 UniversalLink 是否配置正确,简单的检验方法为:将链接写入备忘录,点击后是否可以跳转至 Safari,且顶部提示打开 App。
    • 检查是否将微信加入了白名单,具体参考 example 中 Info.plist 中的配置

安卓端编译失败

  1. 检查Kotlin版本,打开build.gradle文件,查看以下配置
    buildscript {
        ······
        ext.kotlin_version = '1.4.10'
        ······
    }
    
    确保项目中使用的 Kotlin 版本符合要求(具体版本号以 example 中为准);
  2. 检查 Android 目录下build.gradle文件中 gradle 插件版本:classpath 'com.android.tools.build:gradle:3.6.3'gradle-wrapper.properties文件中的 gradle 版本是否匹配:distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-bin.zip,两者的匹配规则见Android官网:Update Gradle

无法调起支付

  1. 先认真阅读 微信支付业务流程,确保操作没问题;

  2. 打印微信返回的错误码,对照下面的表格排查:

    名称 描述 解决方案
    0 成功 展示成功页面
    -1 错误 可能的原因:签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常等。
    -2 用户取消 无需处理。发生场景:用户不支付了,点击取消,返回APP。
  3. 大部分情况下 errorCode 为 -1,请按照以下两部来进一步检查:

    • 检查签名、AppId、商户 ID 等配置是否正确(前两项可以通过检查是否可以成功调用分享来决定);
    • 如果确保配置正确,那就只可能是后端生成的订单信息有误,请让后端排查错误,大概率是 AppId 写错了。

安卓端编译报错AndroidX相关

如果报错含有 “AndroidX”、“support” 等相关字眼,提示包重复,请将自己的项目升级,支持 AndroidX,具体参考:Migrating to AndroidX

WeChat Not Installed on iOS?

iOS 9系统策略更新,限制了http协议的访问,此外应用需要在“Info.plist”中将要使用的URL Schemes列为白名单,才可正常检查其他应用是否安装。 受此影响,当你的应用在iOS 9中需要使用微信SDK的相关能力(分享、收藏、支付、登录等)时,需要在“Info.plist”里增加如下代码(不会配请参考example):

xml
<key>LSApplicationQueriesSchemes</key>
<array>
<string>weixin</string>
<string>weixinULAPI</string>
</array>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>

如果没有安装微信,微信登录不了,导致iOS审核失败

fluwx 提供了检查用户是否安装微信的方法:isWeChatInstalled(),iOS 使用微信相关功能前,务必先检查微信是否安装,没有安装微信的话请务必隐藏微信相关功能。

Failed to notify project evalution listener

Failed to notify project evalution listener

isWeChatInstalled返回false

请查看该 issue 34 ,检查 UniversalLink 是否配置正确,是否配置了白名单;如果重写了 AppDelegate,请检查配置是否正确。

Kotlin报错:XXX is only available since Kotlin x.xx and cannot be used in Kotlin x.xx

  1. 请检查 IDE 安装的 Kotlin 插件版本是否符合 fluwx 要求:AS 打开"设置-->Plugin-->Koltin"查看插件版本;
  2. 请检查项目中使用的 Kotlin 版本:打开 build.gradle 文件,查看以下配置(具体版本号以 example 为准)
    buildscript {
        ······
        ext.kotlin_version = '1.3.11'
        ······
    }
    

listen监听多次调用

请查看该 issue 36 。这个问题是由于 listen 被多次注册导致的,使用者自己代码的问题,非 fluwx 导致的,请在合适的时机将 listen cancel 掉:

StreamSubscription<WeChatAuthResponse> _wxlogin;
_wxlogin = fluwx.responseFromAuth.listen((val) {})
@override
  void dispose() {
	_wxlogin.cancel();
}

分享完成或者取消分享后App崩溃

如果你手动注册了 WXEntryActivityWXPayEntryActivity,请检查 Manifest 中包名是否写对了。

iOS编译错误:No such module 'fluwx'

如果项目本身是在 Android 环境配置的,移到 iOS 环境的时候,会出现该问题,请按照正常步骤配置。

支付成功后,按物理按键或手机自动返回商户APP,监听不到返回数据

有人反应会出现 fluwx.responseFromPayment.listen 监听无效,无法获取支付结果,建议可以直接向服务器查询是否成功。

iOS报错:Specs satisfying the fluwx (from .symlinks/plugins/fluwx/ios) dependency were found, but they required a higher minimum deployment target.

请在在 pod file 里将 iOS 项目 deployment target 改到 9.0。

ResponseType与Dio插件中的命名冲突

使用as的方式导包即可:import 'package:fluwx/fluwx.dart' as fluwx;

ShareSDK(分享插件)和Fluwx(微信支付插件)存在冲突

  1. 将 ShareSDK 的/ios/sharesdk.podspec里的 s.dependency 'mob_sharesdk/ShareSDKPlatforms/WeChat' 改为 s.dependency 'mob_sharesdk/ShareSDKPlatforms/WeChatFull'
  2. 删除 fluwx 的/ios/Lib里的libWeChatSDK.a,在/ios/fluwx.podspec里添加s.dependency 'mob_sharesdk/ShareSDKPlatforms/WeChatFull'

图片加载失败?

  1. 检查是否是图片大小过大,过大请压缩;
  2. 检查图片路径是否是符合要求的 scheme 形式,具体规则请看:都支持什么图片
  3. 如果是使用的 Asset 图片,请不要将图片放在assets文件夹中,可能会读取不到。

iOS registerWxApi 返回 -1

检查初始化时 APP ID 以及 Universalink 是不是写对了,简单的检验方法为:将链接写入备忘录,点击后是否可以跳转至 Safari,且顶部提示打开 App。

分享后,打开微信出现未审核应用

微信自己做的限制,非 fluwx 问题,建议找微信客服

分享怎样知道是成功分享了还是取消了没有分享

无法获取。请阅读微信分享文档:微信App分享功能调整。现在开始微信SDK不再返回用户是否分享完成事件,取消/成功统一全部返回成功。

运行时报错kotlinx相关

检查是否开启混淆;可以参考这个 issue,请确保宿主 app Kotlin 版本支持 kotlinx。

android手机在拉起微信前会弹出选择微信分身页面

微信分身是属于系统范畴的问题,与Fluwx无关。

android代码混淆

请手动给 lib 里的 package 添加混淆规则,具体参考微信文档。

参考文章

iOS-微信SDK更新后需要UniversalLink解决方案 flutter使用fluwx调通微信支付 Flutter ios 使用fluwx配置微信分享