Mini-Program Development FAQ

1. How to enable debug mode for a Mini-Program?

Enabling the vConsole in a Mini-Program means enabling the debug mode. You can add the configuration code "debug": true to the app.json file of the Mini-Program to enable debug mode.

Alternatively, after uploading the Mini-Program to the FinClip Management Console, you can enter the Mini-Program via Manage Mini-Program -> Development Version or Trial Version in the FinClip App, then click the More Menu -> Enable Debug in the upper right corner to enter the Mini-Program's debug mode.

2. How to convert an HTML5 project to a Mini-Program?

If you use front-end development frameworks (such as kbone/Taro/uniapp) to develop Mini-Programs, you can directly use the native framework to export the HTML5 project as a Mini-Program. However, for native HTML5 projects, FinClip currently cannot directly convert your HTML5 project into a Mini-Program.

But you can also open the page by using the WebView component in the Mini-Program, i.e.:

    <web-view src="www.finclip.com"></web-view>

Or open the page using data binding, i.e.:

    <web-view :src="{{webViewUrl}}"></web-view>

After configuration, please add the domain information that the Mini-Program needs to open in Development Settings -> Domain Management. You can click here (opens new window) to view the Domain Management feature introduction.

3. Can FinClip Mini-Programs be developed using Alipay or ByteDance's development tools?

Yes. Currently, FinClip has the best compatibility with WeChat Mini-Programs. Mini-Programs developed based on WeChat can achieve a better usage and development experience on the FinClip platform.

If developers want to migrate Mini-Programs developed via Alipay or ByteDance to FinClip, they can try the following steps:

• Use the Mini-Program development tools provided by Alipay or ByteDance to convert the Mini-Program into a WeChat Mini-Program first, then upload the code package to FinClip;
• Manually replace the file extensions and API namespace headers with ft.xxx, but some features may not be available due to limitations in different platforms.

To avoid compatibility issues caused by different frameworks, it is recommended to use the Compatibility Check in the Developer Tools to inspect the Mini-Program code package.

4. Which Mini-Program frameworks are supported by FinClip for exporting Mini-Programs?

Currently, third-party Mini-Program development frameworks with good compatibility in FinClip include:

• Taro (opens new window)
• kbone (opens new window)
• uni-app (opens new window) (Only supports Mini-Programs generated via uni-app)

Third-party UI frameworks with good compatibility include:

• Vant (opens new window)
• iView (opens new window)
• WeUI Component Library (opens new window)

When a Mini-Program uses certain platform-specific APIs, it may also cause the Mini-Program to fail to run normally after upload. It is recommended to use the Compatibility Check in the Developer Tools to inspect the Mini-Program code package.

5. How to implement third-party login in a FinClip Mini-Program?

You can click the links below to view the relevant setup methods for iOS and Android:

• Android - Refer to [Android SDK FAQ 2.36] for setup
• iOS - Refer to [iOS SDK FAQ 2.19] for setup

6. How to integrate WeChat login for a FinClip Mini-Program?

Generally, WeChat Mini-Program authorization login can only be performed within the WeChat App, meaning it is authorized by the WeChat App to the WeChat Mini-Program. For FinClip Mini-Programs, you need to integrate the WeChat SDK into your Host-App and perform the integration to complete the App login functionality.

However, if you want to directly reuse the WeChat login functionality within a FinClip-based Mini-Program, we also provide a corresponding implementation method. You can click Mini-Program Login FAQ to view the solution we provide.

7. How to integrate third-party payment for a FinClip Mini-Program?

To integrate WeChat Pay in a Mini-Program, you need to introduce a third-party payment SDK (such as the WeChat Pay SDK or Alipay SDK) into your Host-App. You can click Mini-Program Payment FAQ to view the WeChat Pay solution we provide.

8. After a Mini-Program update is released, when can users get the latest version?

Depending on whether the user has opened the Mini-Program before, there are three scenarios:

1. If the user has never opened the Mini-Program before, it will first download the Mini-Program and open it after the download is successful.
2. If the user has opened the Mini-Program before, when opening it, the already downloaded Mini-Program will be opened by default, while simultaneously checking if there is an update for the Mini-Program. If an update exists, the new version of the Mini-Program will be downloaded. When the user opens the Mini-Program again and finds that the new version has been downloaded, the new version will be opened directly.
3. If the Mini-Program is closed quickly every time it is opened, or if the network condition is poor and the new version download is not completed during use, the old version will still be opened next time.

9. When opening a Mini-Program on a low-version Android device, it shows a white screen or prompts "service load timeout". How to handle this?

Generally, some JS syntax in the Mini-Program code has compatibility issues on low-version Android phones. Lower version systems may not support newer JS syntax. You can try checking the option [Convert ES6 to ES5] in the IDE's detail settings, which can resolve most compatibility issues.