FAQ

Error occured during compilation: "does not contain a binary artifact"

Cause: The xcframeworks/ directory is either empty or not present. This happens because you do not run sync_from_local.sh --executeto synchronize the artifact.

Solution: Run the following commands before compilation.

cd IAPMiniProgram-SPM
bash Scripts/sync_from_local.sh --execute

Runtime crash - unrecognized selector

Cause: The IAPMiniProgram SDK is distributed as an Objective‑C static library and contains a large number of Objective‑C Categories. It relies on the -ObjC linker flag to force these categories to be loaded. Otherwise, the linker will strip out Category implementations that are not directly referenced, leading to a runtime crash.
Solution: Check whether Build Settings → Other Linker Flags includes -ObjC (must be configured for both Debug and Release phases).

How to integrate GoogleMaps SDK？

The IAPMiniProgram GoogleMap product does not include the GoogleMaps/GooglePlaces SDK. It is up to the integrating party to handle integration and management.

References:

• https://developers.google.com/maps/documentation/ios-sdk/config
• https://developers.google.com/maps/documentation/places/ios-sdk/config

Should the old copy_spm_resources.sh script be removed after the upgrade?

It is recommended to remove it. The copy_spm_resources.sh script has been deprecated following the dual-mode refactoring of resource loading. Keeping this script will not cause functional issues (container resources take priority during SDK lookups), but it will result in resource duplication and App package redundancy.