# 开发者社群常见问题汇总

提示

以下内容均来自 FinClip 开发者社群，我们将社群中开发者的问题定期整理归纳，整理在文档中心，或发布于 FinClip 博客 (opens new window)。

# 1. 请问能支持的小程序分包大小是多少？总包大小是多少？

问：对于用微信 IDE 开发的大于 10M 的小程序包有何解决方案吗？
答：目前分包大小不限制，总包限制 10M，可以在我们的开发者工具上传无代码包大小限制。

# 2. 新建项目的时候，可以设置生成的文件按微信小程序的扩展名吗？

问：开发者工具新建项目的时候，可以设置生成的文件是按微信小程序的扩展名吗？
答：目前不支持。

# 3. 如何获取小程序启动时参数？

问：启动小程序时，携带的参数，在小程序里怎么获取？
答：在小程序onLaunch onLoad生命周期中可以获取。

# 4. 使用时应该选择哪种加密方式？

问：配置小程序服务器信息时，应该选择哪种加密方式？这里的加密方式是必填内容吗？
答：加密方式是必填的，如果没有其他要求请选择 MD5 形式加密，如果集成后提示报错，需要在初始化的时候设置DebugMode为true，然后过滤 http 相关的日志。

# 5. 小程序提交审核后是谁来进行审核？

问：个人开发者在后台提交审核的小程序是官方审核的吗?企业帐号也是官方审核吗？如果我们想自行审核需要如何处理？
答：都是官方审核的，如果需要自行审核，可以联系商务对整套系统进行私有化，就可以自行审核了。在之后的 SaaS 版本中，小程序审核工作也是由企业自行完成的。

# 6. 使用开发者账号登录 FinClip App ，“管理小程序”是空的，要如何处理？

问：使用开发者账号登录 FinClip App ，“管理小程序”页面是空的，“扫码打开小程序”在扫描后，‘嘀’一下之后就没反应了，为什么？
答： FinClip App 版本太旧了，需要更新一下。

# 7. 如何在 FinClip Studio 中自定义接口测试呢？

问：自定义小程序接口，在 FinClip Studio 里有办法使用么？想用体验版但是携带不了参数，于是我想用自定义小程序接口在启动了小程序之后获取一次所需参数，但是在编译的时候报错。
答：可以在开发者工具里 mock 接口，但是这里 mock 的接口一定是已经完成开发且可以使用的。且在使用前需要在FinClipConf.js中进行配置。

# 8. 需要微信生态的插件是否可以直接运行？

问：微信小程序中的插件可以直接在 FinClip 中使用吗？
答：FinClip 支持的插件仅支持自有的插件，微信上的 plugin 是封闭的无法通过外部接口获取，所以是用不了的。

# 9. 微信原生小程序的代码是否直接可以运行在 FinClip 上？

问：微信原生小程序的代码是否直接可以运行，需要其他转化操作吗？
答：可以直接运行，不需要第三方工具进行适配或转化。FinClip 同时也支持 uniapp，kbone，taro 等各种框架输出的小程序源码，只需要编译为微信小程序代码即可使用。

# 10. 在小程序里，如何关闭自己回到宿主 APP ？

问：请问下，在小程序里，如何关闭自己回到宿主 APP？
答：点击右上角小程序关闭按钮，或者调用 ft.exitMiniProgram 接口。

# 11. 预览小程序时，提示“当前环境与SDK 初始化环境不一致”，要怎么处理？

问：我在手机上预览小程序时，提示“当前环境与SDK 初始化环境不一致”，要咋办？
答：请确定您在移动 App 中配置的服务器地址与相关内容，与应用绑定页面中的对应内容一致。

# 12. App 和小程序怎么本地联调呢？

问：App 和小程序怎么进行本地联调？总不能把 App 上架之后再去查看吧？
答：可以在小程序中使用 vconsole 进行测试。

# 13. FinClip 支持 subPackages 分包吗？

问：支持 subPackages 分包吗？
答：支持。

# 14. 使用 Flutter 接入的话，是否支持 FinClip 使用自定义 API 通过 success 方法接收回调数据？

问：使用 Flutter 接入的话，是否支持 FinClip 使用自定义 API 通过 success 方法接收回调数据？
答：支持的，typedef ExtensionApiHandler = Future Function(dynamic params) 就可以实现了。这个也是原生 Flutter 的方法所实现的。

# 15. 小程序通过自定义 API 向 Flutter 请求数据，这时 Flutter 该如何把数据传给小程序？

问：请问，当 Flutter 应用内的小程序被打开时，小程序通过自定义 API 向 Flutter 请求数据，这时 Flutter 该如何把数据传给小程序？目前自定义 API 没有找到对应的接口？
答：您可以查看 Flutter 集成文档处理。

# 16. 是否有区分小程序版本的相关 API？

问：怎么区分开发版本，体验版，和线上版本。有 API 可以获取是运行的哪个版本吗？
答：您可以使用FinAppClient.appletApiManager.getAppletInfo("appId")?.appType进行区分。

# 17. 一个小程序可以在不同 App 做到定制化吗？

问：一个小程序可以在不同 App 做到定制化吗？比如 App1-导航栏红背景，App2-导航栏黑背景？
答：可以的，小程序里面可以获取 App 的信息，然后在小程序里面自定义。

# 18. 官方文档没有 Swift 的接入文档，什么时候可以出呢？

问：官方文档没有 Swift 的接入文档，什么时候可以出呢？
答：已经发布在文档中心了，您可以点击这里查看。

# 19. FinClip 和 Uniapp 相比有哪些优势？

问：FinClip 与 Uniapp 有哪些优势呢？
答：主要有这样几个区别：

FinClip 小程序 SDK 支持纯 wxml 微信小程序运行，还支持包括 uniapp 在内的 Taro、kbone 等多种第三方框架的小程序，uni 小程序 SDK 仅支持使用 uni-app 开发框架开发的小程序；
FinClip 小程序 SDK 则只会使 APP 包增大 2M 左右，uni 小程序 SDK 可能会增大7~16M左右；
FinClip 小程序 SDK 支持同时运行多个实例，uni 小程序 SDK 仅支持同时运行一个小程序实例；
FinClip 小程序 SDK 同时支持 Android、iOS、Flutter、ReactNative、Windows 等多种类型的 SDK，uni 小程序SDK仅支持Android、iOS 两种类型；
FinClip 小程序 SDK拥有完善的管理平台，可以协助开发者更好的对小程开发、测试、上下架等流程进行管理；
FinClip 采用与微信小程序一致的架构，逻辑层与渲染层分离，uni 小程序采用 webview 渲染或者原生渲染（React Native/weex）的技术架构。

您可以查看这篇文章 (opens new window)了解详细信息。

# 20. 在 iOS 15 系统上，中文输入法会直接崩掉，为啥？

问：iOS 15 系统上，中文输入法会直接崩掉，怎么办？
答：尝试更新 SDK 版本至 2.34.3 以上在进行尝试。

# 21. 小程序后退到 webview 页面, 有类似 webview 后退通知小程序ft.miniProgram.postMessage 的方法吗？

问：小程序后退到 webview 页面, 有类似 webview 后退通知小程序ft.miniProgram.postMessage的方法吗？
答：目前小程序 API 中没有这个功能。如果想要实现可以使用自定义 API 的方式由原生 APP 触发 h5 中 WebView 的事件，如：

ft.miniProgram.navigateBack({
        delta: 1
      })

# 22. Flutter 接入 FinClip，跳转打开小程序的转场动画可以有别的形式吗？

问：Flutter 接入 FinClip，跳转打开小程序的转场动画可以有别的形式吗？
答：有的，还有从左往右的方式。您可以查看这篇文章。

# 23. 请问请问灰度发布和和小程序的上架下架的区别是什么？

问：请问灰度发布和和小程序的上架下架的区别是啥啊？
答：就是给部分用户推送小程序灰度版本，从而进行线上测试，具体可以查看这篇文章。

# 24. 请问在H5应用中调用哪个 JSSDK 可以关闭小程序？

问：请问下，在H5应用中调用哪个 JSSDK 可以关闭小程序啊。就是我想点嵌套在小程序中h5页面里的返回，也能达到右上方的关闭按钮的效果？
答：调用 ft.exitMiniProgram 接口即可。

# 25. 如何打开小程序中的调试器？

问：如何打开小程序中的调试器，查看调试日志等相关信息呢？
答：在app.json文件中增加"debug":true即可。

# 26. 示例小程序，凡泰社区可以代码直接上传吗？

问：示例小程序，凡泰社区可以代码直接上传吗？DEMO 上的小程序都是“使用权限到期”？
答：可以自行从小程序市场 (opens new window)中下载，获取完整的小程序代码。

# 27. H5 和小程序通信怎么连接的呀？

问：H5 和小程序通信怎么连接的呀？
答：使用ft.miniProgram.postMessage接口通信即可。

# 28. 如何引入 FinClip 的 JSSDK 呢？

问：如何引入 FinClip 的 JSSDK 呢？我想在应用里引入凡泰的 JSSDK 的操作，不知道怎么办？
答：您可以查看这里了解详细信息。

# 29. 我觉得 FinClip 很符合我公司的实际需要，如何联系商务？

问：麻烦问下 FinClip 是怎么收费的？我觉得很符合我公司实际需要。
答：请致电 0755-86967467 联系商务经理。

# 30. SDK 指纹配置项是指什么？怎么配置？

问：SDK 指纹配置项是指什么，怎么配置啊？
答：如果使用的是 FinClip.com 版本或者私有化产品是不需要指纹的，您可以看下头文件的描述内容。

# 31. 我们对接的小程序有多个 apiServer 时怎么处理？

问：我们对接的小程序有多个apiServer时怎么处理？
答：从2.13.102版本开始支持配置多个服务器信息，可以同时打开不同环境中的小程序。您可以查看这里获取详细信息。

# 32. FinClip 有体验的 App 吗？

问：FinClip 有体验的 App 吗？
答：有的，您可以在应用市场中搜索“ FinClip App 、FinClip”进行查找，或点击这里获取资源。

# 33. FinClip 小程序不是微信小程序吧，需要用你们的语法新开发吗？

问：FinClip 小程序不是微信小程序吧，需要用你们的语法新开发吗？
答：我们不是一种语法，FinClip 是我们的小程序开放平台，我们是兼容微信的。

# 34. "navigationStyle": "custom"配置为什么不生效？

问：请问下这个配置了怎么不生效啊，对 webview 组件无效是吗？
答：是的，对 webview 暂不生效。

# 35. 苹果审核的时候可以看到我后台已经上架的小程序吗？如何处理相关事宜？

问：苹果审核的时候可以看到我后台已经上架的小程序吗？如何处理相关事宜？
答：无法看到，关于苹果审核事宜，您可以查看这里获取详情。

# 36. 安卓端小程序关闭动画如何设置？

问：关闭小程序的时候，安卓端小程序关闭动画如何设置？
答：您可以查看这里，使用NoneAnim即可。

# 37. 是否支持在原生 APP 一级界面展示小程序？

问：我们是否支持在原生 APP 一级界面展示小程序？
答：支持。在App 加载显示闪屏时，就在根页面打开小程序，然后隐藏掉关闭按钮即可。

# 38. FinClip 支持小程序加载过一次后，离线打开吗？

问：FinCLip 支持小程序加载过一次后，离线打开吗？
答：支持，我们有离线包的功能。

# 39. FinClip 与 mPaaS 有啥区别啊？

问：FinClip 与 mPaaS 有啥区别啊？
答：您可以查看这篇文章 (opens new window)获取答案。

# 40. 打开小程序时，传递的参数如何接收呢？

问：咨询一下，FinClip 移动端接入SDK后，打开小程序的时候，传递给小程序的参数，小程序那边怎么接收呀？
答：在小程序的 App 生命周期方法里比如onLaunch里可以从option里读取到。

# 41. 当前 FinClip 在海外有集群吗？

问：当前 FinClip 在海外有集群吗？k8s 有部署文档吗？
答：暂时没有海外集群，我们的 SaaS 集群地域是广州，不能保证海外的连接性。如果有需要的话，我们是可以基于私有化采购的基础上，帮你们在指定云上做部署。比如我们之前已经完成过阿里海外云部署。目前社区版有一键部署指南，可以查看这里。

# 42. 小程序修改名字后多久生效？

问：小程序修改名字后多久生效啊？我改了两个小时，已关联小程序里还是没变呢。重新关联也不行。
答：修改后需要提交小程序上架申请，上架审核通过后生效。

# 43. 支持空安全了吗？

问：支持 Flutter 空安全吗？
答：支持。

# 44. 请问小程序前端可以获取宿主 App 的 BundleID 吗？

问：请问小程序前端可以获取宿主 App 的 BundleID 吗？
答：可以的，您可以查看这里 (opens new window)获取详情。

# 45. 自有 App 如何实现微信的授权登录的？

问：自有 App 如何实现微信的授权登录的？
答：自有app是无法实现微信的授权登录的，可以让小程序对接自己 App 的登录，用自定义接口可以实现小程序与宿主应用之间的通信。

# 46. 写小程序应该使用哪种框架？

问：我现在是从零开始，看网上资源太多，反而不知道应该从哪种框架写起，怎么办？
答：您可以尝试通过 taro，kbone 写起，我们在这篇文章 (opens new window)中也对小程序框架进行了对比，可以进行了解。

# 47. 引用base64格式图片报错怎么办？

问：我在 ftss 中引用 base64 格式图片时报错怎么办？
答：可能是因为没有遵循base64标准导致的，如：'data:'后有多余空格

# 48. 自定义组件无法渲染怎么办？

问：我在开发小程序时使用了自定义组件，但最终的渲染效果不正确，为啥？
答：为保证自定义组件正常渲染，需要在组件json文件中提前声明"component": true

# 49. 如何配置导航栏的样式？

问：我想修改小程序顶部的导航栏样式，需要怎么办？
答：FinClip 目前支持配置顶部导航栏样式，或导航栏中右侧胶囊按钮样式，您可以点击蓝色文字查看。

# 50. 有哪些微信登录的 API 是暂时不支持的？

问：我使用了微信的小程序权限 API，想请问下哪些是当前暂不支持的？
答：目前 FinClip 暂不支持ft.checkSession

# 51. 如何获取 FinClip 最新版本？

问：我在使用 FinClip 时，发现需要使用{latest.version}，应该如何获取？
答：您可以在「小程序 SDK」目录下选择对应的 SDK 环境，并且在更新日志中获取最新版本号。

# 52. 如何实现 APP 与小程序的联合登录（或单点登录）？

问：希望能够实现 APP 原生、小程序、小程序与小程序之间，任意位置登录后，其他模块均能同步该登录信息，即：一方登录成功或者退出登录都要通知到对方？
答：建议方案如下，开发者可根据自身业务灵活选择：

APP 登录，在打开小程序时可以通过小程序启动方式传参的方式，实现通知到小程序
- 查看Android传参方式
- 查看iOS传参方式
小程序登录，可以调用自定义 API，通知 APP
- 查看Android注册自定义API方法
- 查看iOS注册自定义API方法

# 53. 如何区分小程序的入口渠道？

问：小程序同时在多个 APP 中展业时，如何在小程序内区分当前所处的不同环境，同时支持根据不同 APP 环境记录对应数据？如公司A 用自己的渠道号来对接小程序，公司B 亦用自己的渠道号对接。如何在小程序内通过渠道号来区分对应的业务数据，从而支撑业务分析呢？
答：建议方案如下，开发者可根据自身业务灵活选择：

使用 UserAgent，直接设置环境判断，设置方式如下：
打开小程序时，由 APP 提供启动参数：
自行注册自定义 API 方式实现该功能：