tencent cloud

All product documents
Tencent Cloud Super App as a Service
SDK Integration FAQs
Last updated: 2025-03-17 17:50:09
SDK Integration FAQs
Last updated: 2025-03-17 17:50:09

For XCode 15 and earlier versions, the mini program crashes on iOS 12 and later versions

Add `-Wl,-ld_classic` to the project's compilation options.


Xcode15 compiles a new project and introduces the pod library with the error Sandbox: rsync.sanba deny(1) file-write-create xxx




Solution: Build Settings search for sandbox, change User Script Sandboxing in Build Options to NO.




Apple M-Series Chip PC Emulator runs abnormally

The current version of the SDK needs to be run through Rosetta for running on M-Series chip PC emulators.
Before xcode14:
We can right click xcode->show profile->check open with Rosetta, so it is running on the emulator.

After xcode14:
xcode Open Project > Product > Destination > Destination Architectures and you can choose which mode of simulator to open it with.
We will choose the emulator ending with (Rosetta).



When issues occur during download, opening, or searching for mini programs, the SDK will throw error codes. These codes help identify whether the issue is with the gateway, backend, or SDK.

Gateway errors

If the logs contain TMFSharkXXX related errors, the issue is with the gateway. Common errors include:
TMFSharkTaskErrorDomain
TMFSharkDataAccessLayerErrorDomain
TMFSharkRequestErrorDomain
For details about the error codes, see iOS Error Codes.

Backend service errors

If the logs contain TMAMiniAppErrorDomain related errors, the issue is likely with the mini program backend. Common errors include:
TMAMiniAppErrorFileMd5VerifyFail - The MD5 verification of the mini program package failed.
TMAMiniAppErrorConfigInitError - Incorrect initialization information or uninitialized. Check the configuration file.
TMAMiniAppErrorJSSDKDownloadFail - Mini program base library download failed.
TMAMiniAppErrorErrorLink - Incorrect mini program link.
For details about the error codes, see iOS Error Codes.

SDK errors

If the logs contain MFMiniApp Error but do not include TMFSharkXXX or TMAMiniAppErrorDomain errors, the issue may be related to console configurations. Common issues include:
Domain name blocklist: appID(appName)skipDomainCheck,but url:(domainUrl)is in black list. Search "skipDomainCheck,but url:"in the log to confirm the issue.
Domain name allowlist: appID(appName) check url in domainList, result is 0. Search "in domainList, result is " to confirm the issue.
Privacy API: If calling sensitive APIs (e.g., chooseLocation, getLocation, choosePoi) and the console has related permissions configured, you might see errors like PluginEngine |eventName(chooseLocation) fail. no permission. Ensure the mini program has the necessary permissions enabled.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

7x24 Phone Support