# Developer Community FAQ Collection
Note
The following content is sourced from the FinClip developer community. We regularly organize and summarize questions from the community, compiling them in the documentation center or publishing them on the FinClip Blog (opens new window).
# 1. What is the supported subpackage size for Mini-Programs? What is the total package size?
Q: Are there any solutions for Mini-Program packages larger than 10M developed using the WeChat IDE?
A: Currently, there is no limit on subpackage size, but the total package is limited to 10M. You can upload code packages without size restrictions using our Developer Tools.
# 2. When creating a new project, can the generated files be set to use WeChat Mini-Program file extensions?
Q: When creating a new project in the Developer Tools, can the generated files be set to use WeChat Mini-Program file extensions?
A: Currently, this is not supported.
# 3. How to obtain the startup parameters when a Mini-Program launches?
Q: How can parameters passed when starting a Mini-Program be obtained within the Mini-Program?
A: They can be obtained in the onLaunch and onLoad lifecycle methods of the Mini-Program.
# 4. Which encryption method should be chosen during use?
Q: When configuring the Mini-Program server information, which encryption method should be selected? Is this encryption method mandatory?
A: The encryption method is mandatory. If there are no other requirements, please choose MD5 encryption. If an error occurs after integration, you need to set DebugMode to true during initialization and then filter the HTTP-related logs.
# 5. Who reviews the Mini-Program after it is submitted for review?
Q: Are Mini-Programs submitted for review by individual developers in the backend reviewed by the official team? Are enterprise accounts also reviewed by the official team? How can we handle self-review if needed?
A: All are reviewed by the official team. If self-review is required, you can contact the business team to privatize the entire system, which will allow self-review. In future SaaS versions, Mini-Program review work will also be handled by the enterprises themselves.
# 6. When logging into the FinClip App with a developer account, the "Manage Mini-Programs" section is empty. How to handle this?
Q: When logging into the FinClip App with a developer account, the "Manage Mini-Programs" page is empty. After scanning a code to open a Mini-Program, there is no response after the 'beep' sound. Why?
A: The FinClip App version is too old and needs to be updated.
# 7. How to customize interface testing in FinClip Studio?
Q: Can custom Mini-Program interfaces be used in FinClip Studio? I want to use the trial version but cannot carry parameters. So, I thought of using a custom Mini-Program interface to obtain the required parameters after starting the Mini-Program, but an error occurs during compilation.
A: You can mock the interface in the Developer Tools, but the mocked interface must be fully developed and functional. Additionally, it needs to be configured in FinClipConf.js before use.
# 8. Can plugins from the WeChat ecosystem run directly?
Q: Can plugins from WeChat Mini-Programs be used directly in FinClip?
A: FinClip only supports its own plugins. Plugins on WeChat are closed and cannot be accessed via external interfaces, so they cannot be used.
# 9. Can WeChat native Mini-Program code run directly on FinClip?
Q: Can WeChat native Mini-Program code run directly, or are other conversion operations needed?
A: It can run directly without the need for third-party tools for adaptation or conversion. FinClip also supports Mini-Program source code output by various frameworks like uniapp, kbone, and taro; it only needs to be compiled into WeChat Mini-Program code to be used.
# 10. How to close the Mini-Program and return to the Host-App from within the Mini-Program?
Q: How can I close the Mini-Program and return to the Host-App from within the Mini-Program?
A: Click the close button in the upper right corner of the Mini-Program, or call the ft.exitMiniProgram interface.
# 11. When previewing a Mini-Program, the prompt "Current environment does not match the SDK initialization environment" appears. How to handle this?
Q: When previewing a Mini-Program on my phone, I get the prompt "Current environment does not match the SDK initialization environment." What should I do?
A: Please ensure that the server address and related content configured in your mobile App are consistent with the corresponding content in the App binding page.
# 12. How to perform local debugging between the App and the Mini-Program?
Q: How to perform local debugging between the App and the Mini-Program? Surely we don't have to publish the App first to check, right?
A: You can use vconsole within the Mini-Program for testing.
# 13. Does FinClip support subPackages?
Q: Does FinClip support subPackages?
A: Yes, it does.
# 14. When integrating with Flutter, does FinClip support using custom APIs to receive callback data via the success method?
Q: When integrating with Flutter, does FinClip support using custom APIs to receive callback data via the success method?
A: Yes, it is supported. It can be achieved with typedef ExtensionApiHandler = Future Function(dynamic params). This is also implemented using native Flutter methods.
# 15. When a Mini-Program requests data from Flutter via a custom API, how should Flutter pass the data back to the Mini-Program?
Q: When a Mini-Program within a Flutter application is opened, and it requests data from Flutter via a custom API, how should Flutter pass the data back to the Mini-Program? Currently, I haven't found the corresponding interface for the custom API?
A: You can refer to the Flutter Integration Documentation for handling this.
# 16. Are there APIs to distinguish between Mini-Program versions?
Q: How to distinguish between the development version, trial version, and production version? Is there an API to get which version is running?
A: You can use FinAppClient.appletApiManager.getAppletInfo("appId")?.appType to distinguish.
# 17. Can a single Mini-Program be customized for different Apps?
Q: Can a single Mini-Program be customized for different Apps? For example, App1 has a red navigation bar background, and App2 has a black navigation bar background?
A: Yes, it can. The Mini-Program can obtain the App's information and then customize within the Mini-Program.
# 18. The official documentation lacks Swift integration documentation. When will it be available?
Q: The official documentation does not have Swift integration documentation. When will it be available?
A: It has already been published in the documentation center. You can view it by clicking here.
# 19. What are the advantages of FinClip compared to Uniapp?
Q: What are the advantages of FinClip compared to Uniapp?
A: There are several main differences:
- The FinClip Mini-Program SDK supports running pure wxml WeChat Mini-Programs and also supports Mini-Programs from various third-party frameworks including uniapp, Taro, and kbone. The uni Mini-Program SDK only supports Mini-Programs developed using the uni-app framework.
- The FinClip Mini-Program SDK only increases the APP package size by about 2M, whereas the uni Mini-Program SDK may increase it by 7~16M.
- The FinClip Mini-Program SDK supports running multiple instances simultaneously, while the uni Mini-Program SDK only supports running one Mini-Program instance at a time.
- The FinClip Mini-Program SDK supports various types of SDKs including Android, iOS, Flutter, ReactNative, and Windows. The uni Mini-Program SDK only supports Android and iOS.
- The FinClip Mini-Program SDK has a comprehensive management platform that helps developers better manage the Mini-Program development, testing, release, and takedown processes.
- FinClip adopts an architecture consistent with WeChat Mini-Programs, separating the Logic Layer and the View Layer. uni Mini-Programs use a webview rendering or native rendering (React Native/weex) technical architecture.
You can view this article (opens new window) for more details.
# 20. On iOS 15, the Chinese input method crashes directly. Why?
Q: On iOS 15, the Chinese input method crashes directly. What should I do?
A: Try updating the SDK version to 2.34.3 or above and try again.
# 21. When navigating back from a Mini-Program to a webview page, is there a method similar to ft.miniProgram.postMessage for the webview to notify the Mini-Program upon going back?
Q: When navigating back from a Mini-Program to a webview page, is there a method similar to ft.miniProgram.postMessage for the webview to notify the Mini-Program upon going back?
A: Currently, this functionality is not available in the Mini-Program API. If you want to implement it, you can use a custom API method to trigger the WebView event in H5 from the native APP, for example:
ft.miniProgram.navigateBack({
delta: 1
})
# 22. When integrating FinClip with Flutter, are there other forms of transition animations for opening a Mini-Program?
Q: When integrating FinClip with Flutter, are there other forms of transition animations for opening a Mini-Program?
A: Yes, there is also a left-to-right method. You can view this article.
# 23. What is the difference between grayscale release and the release/takedown of a Mini-Program?
Q: What is the difference between grayscale release and the release/takedown of a Mini-Program?
A: Grayscale release involves pushing a grayscale version of the Mini-Program to a subset of users for online testing. For specifics, you can view this article.
# 24. Which JSSDK should be called in an H5 application to close the Mini-Program?
Q: Which JSSDK should be called in an H5 application to close the Mini-Program? I want clicking the back button in an H5 page embedded in the Mini-Program to have the same effect as the close button in the upper right corner.
A: Call the ft.exitMiniProgram interface.
# 25. How to open the debugger in a Mini-Program?
Q: How to open the debugger in a Mini-Program to view debug logs and related information?
A: Add "debug":true in the app.json file.
# 26. Can the sample Mini-Program, Fino Community, be uploaded directly with code?
Q: Can the sample Mini-Program, Fino Community, be uploaded directly with code? The DEMO Mini-Programs all show "Usage permission expired"?
A: You can download it yourself from the Mini-Program Market (opens new window) to get the complete Mini-Program code.
# 27. How is communication between H5 and the Mini-Program connected?
Q: How is communication between H5 and the Mini-Program connected?
A: Use the ft.miniProgram.postMessage interface for communication.
# 28. How to introduce the FinClip JSSDK?
Q: How to introduce the FinClip JSSDK? I want to introduce Fino's JSSDK operations in my application, but I don't know how?
A: You can view the details here.
# 29. I think FinClip fits my company's actual needs. How to contact the business team?
Q: May I ask about FinClip's pricing? I think it fits my company's actual needs.
A: Please call 0755-86967467 to contact a business manager.
# 30. What does the SDK fingerprint configuration item refer to? How to configure it?
Q: What does the SDK fingerprint configuration item refer to, and how to configure it?
A: If you are using the FinClip.com version or a privatized product, fingerprints are not required. You can check the description in the header file.
# 31. How to handle multiple apiServers for the integrated Mini-Program?
Q: How to handle multiple apiServers for the integrated Mini-Program?
A: Starting from version 2.13.102, configuring multiple server information is supported, allowing Mini-Programs from different environments to be opened simultaneously. You can view the details here.
# 32. Is there an App for experiencing FinClip?
Q: Is there an App for experiencing FinClip?
A: Yes, you can search for "FinClip App" or "FinClip" in the app market, or click here to get the resources.
# 33. FinClip Mini-Programs are not WeChat Mini-Programs, right? Do we need to develop using your new syntax?
Q: FinClip Mini-Programs are not WeChat Mini-Programs, right? Do we need to develop using your new syntax?
A: They are not a different syntax. FinClip is our Mini-Program Open Platform, and we are compatible with WeChat.
# 34. Why does the configuration "navigationStyle": "custom" not take effect?
Q: Why does this configuration not take effect? Is it invalid for the webview component?
A: Yes, it is temporarily ineffective for webview.
# 35. Can Apple reviewers see the Mini-Programs I have already published in the backend during the review? How to handle related matters?
Q: Can Apple reviewers see the Mini-Programs I have already published in the backend during the review? How to handle related matters?
A: They cannot see them. For matters regarding Apple review, you can view the details here.
# 36. How to set the close animation for Mini-Programs on Android?
Q: How to set the close animation for Mini-Programs on Android when closing the Mini-Program?
A: You can view here and use NoneAnim.
# 37. Is it supported to display a Mini-Program on the primary interface of the native App?
Q: Do we support displaying a Mini-Program on the primary interface of the native App?
A: Yes, it is supported. When the App loads and displays the splash screen, open the Mini-Program on the root page and then hide the close button.
# 38. Does FinClip support offline opening of a Mini-Program after it has been loaded once?
Q: Does FinClip support offline opening of a Mini-Program after it has been loaded once?
A: Yes, we have the Offline Package feature.
# 39. What are the differences between FinClip and mPaaS?
Q: What are the differences between FinClip and mPaaS?
A: You can find the answer in this article (opens new window).
# 40. How are the parameters passed when opening a Mini-Program received?
Q: After integrating the FinClip mobile SDK, how does the Mini-Program receive the parameters passed when opening it?
A: In the App lifecycle methods of the Mini-Program, such as onLaunch, they can be read from the option.
# 41. Does FinClip currently have clusters overseas? Is there k8s deployment documentation?
Q: Does FinClip currently have clusters overseas? Is there k8s deployment documentation?
A: There are no overseas clusters for now. Our SaaS cluster region is Guangzhou, and connectivity overseas cannot be guaranteed. If needed, we can help you deploy on a specified cloud based on a privatization purchase. For example, we have previously completed deployments on Alibaba's overseas cloud. Currently, there is a one-click deployment guide for the community edition, which you can view here.
# 42. How long does it take for a Mini-Program name change to take effect?
Q: How long does it take for a Mini-Program name change to take effect? I changed it two hours ago, but it still hasn't updated in the associated Mini-Programs list. Re-associating doesn't work either.
A: After modification, you need to submit a Mini-Program release application. It will take effect after the release review is approved.
# 43. Is null safety supported?
Q: Is Flutter null safety supported?
A: Yes, it is supported.
# 44. Can the Mini-Program frontend obtain the Host-App's BundleID?
Q: Can the Mini-Program frontend obtain the Host-App's BundleID?
A: Yes, you can view the details here (opens new window).
# 45. How does a proprietary App implement WeChat authorization login?
Q: How does a proprietary App implement WeChat authorization login?
A: A proprietary App cannot implement WeChat authorization login. You can have the Mini-Program integrate with your App's login. Communication between the Mini-Program and the Host-App can be achieved using custom interfaces.
# 46. Which framework should be used to write Mini-Programs?
Q: I'm starting from scratch. There are too many resources online, and I'm unsure which framework to start with. What should I do?
A: You can try starting with taro or kbone. We also compared Mini-Program frameworks in this article (opens new window), which you can refer to.
# 47. What to do if referencing a base64 format image causes an error?
Q: What should I do if I get an error when referencing a base64 format image in an ftss file?
A: It might be due to not following the base64 standard, for example, having extra spaces after 'data:'.
# 48. What to do if a custom component fails to render?
Q: I used a custom component while developing a Mini-Program, but the final rendering is incorrect. Why?
A: To ensure the custom component renders correctly, you need to declare "component": true in the component's json file in advance.
# 49. How to configure the navigation bar style?
Q: I want to modify the style of the navigation bar at the top of the Mini-Program. What should I do?
A: FinClip currently supports configuring the Top Navigation Bar Style or the Capsule Button Style on the right side of the navigation bar. You can click the blue text to view.
# 50. Which WeChat login APIs are currently not supported?
Q: I used WeChat's Mini-Program permission APIs. Which ones are currently not supported?
A: Currently, FinClip does not support ft.checkSession.
# 51. How to get the latest version of FinClip?
Q: While using FinClip, I found that I need to use {latest.version}. How should I obtain it?
A: You can select the corresponding SDK environment under the "Mini-Program SDK" directory and obtain the latest version number from the update logs.
# 52. How to implement joint login (or single sign-on) between the App and Mini-Programs?
Q: I hope to achieve that after logging in at any location among the native App, Mini-Program, and between Mini-Programs, other modules can synchronize this login information. That is, login success or logout from one party should notify the others. How?
A: The suggested solutions are as follows. Developers can choose flexibly based on their business:
- App login: When opening a Mini-Program, parameters can be passed via the Mini-Program startup method to notify the Mini-Program.
- Mini-Program login: Can call a custom API to notify the App.
# 53. How to distinguish the entry channel of a Mini-Program?
Q: When a Mini-Program operates in multiple Apps simultaneously, how to distinguish the current different environments within the Mini-Program, and support recording corresponding data based on different App environments? For example, Company A uses its own channel number to integrate the Mini-Program, and Company B also uses its own. How to distinguish the corresponding business data within the Mini-Program by channel number to support business analysis?
A: The suggested solutions are as follows. Developers can choose flexibly based on their business:
- Use UserAgent, directly set environment judgment. Setting methods:
- When opening the Mini-Program, provide startup parameters from the App:
- Implement the function by registering a custom API: