动态与公告

【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告

控制台更新动态

Android SDK 更新动态

iOS SDK 更新动态

Flutter 更新动态

IDE 更新动态

基础库更新动态

产品简介

产品概述

产品优势

应用场景

购买指南

计费概述

按量计费（后付费）

续费指引

停服说明

快速入门

套餐管理

概述

控制台账号管理

存储配置

加速配置

品牌化配置

平台功能

控制台登录

用户和权限体系

小程序管理

小游戏管理

应用管理

商业化

平台管理

用户管理

团队管理

运营管理

安全中心

代码接入指引

Demo 及 SDK 获取

Android

iOS

Flutter

App 服务端接入指南

GUID 生成规则

小程序开发指南

小程序介绍与开发环境

小程序代码组成

指南

框架

组件

API

服务端

JS SDK

基础库

IDE 使用指南

小游戏开发指南

指南

API

服务端

实践教程

小程序登录实践教程

小程序订阅消息实践教程

支付相关实践教程

广告接入实践教程

小游戏订阅消息实践教程

SDK 集成常见问题

PDF

聚焦模式

字号

最后更新时间： 2025-03-17 17:23:29

XCode 15 以上版本编译后，在 iOS 12 及以下设备上出现崩溃问题
在项目编译选项中添加 -Wl,-ld_classic 配置。 
﻿
Xcode15新建项目并且引入pod库后，编译报错 Sandbox：rsync.sanba deny(1) file-write-create xxx
﻿
﻿
﻿
解决办法：Build Settings 搜索 sandbox，把 Build Options 中的 User Script Sandboxing改为 NO。
﻿
﻿
﻿
Apple M 系列芯片电脑模拟器运行异常
当前  SDK 版本对于 M 系列芯片电脑模拟器上运行需要通过 Rosetta 运行。
xcode14之前：
我们可以右键 xcode > 显示简介 > 勾选使用 Rosetta 打开，这样就是在模拟器上运行了。
﻿
xcode14后：
xcode 打开项目 > Product > Destination > Destination Architectures 可以选择用哪种模式的模拟器打开。
我们选择 （Rosetta）结尾的模拟器即可。
﻿
﻿
﻿
在执行下载、打开、搜索小程序等功能产生问题时，SDK会抛出错误码，可根据错误码判断出现问题是在网关、后台还是SDK等阶段。
网关报错
日志中包含了TMFSharkXXX相关的报错，则问题出现在网关，常见的有：
TMFSharkTaskErrorDomain
TMFSharkDataAccessLayerErrorDomain
TMFSharkRequestErrorDomain
错误及其具体原因需要查看对应的错误码﻿
后台服务报错
日志中包含了TMAMiniAppErrorDomain相关的报错，则问题很大可能出现在小程序后台，常见的有：
TMAMiniAppErrorFileMd5VerifyFail -- 小程序包的md5验证不通过
TMAMiniAppErrorConfigInitError -- 初始化信息错误或者未初始化，检查配置文件
TMAMiniAppErrorJSSDKDownloadFail -- 小程序基础库下载失败
TMAMiniAppErrorErrorLink -- 错误的小程序链接
错误及其具体原因需要查看对应的错误码﻿
SDK报错
日志中包含了MFMiniApp Error并且未包含TMFSharkXXX和TMAMiniAppErrorDomain错误，则问题可能出现在控制台相关配置，常见的有：
域名黑名单：appID(appName)skipDomainCheck,but url:(domainUrl)is in black list，搜索日志中关键字"skipDomainCheck,but url:"即可确认域名黑名单问题。
域名白名单：appID(appName) check url in domainList, result is 0，搜索关键字"in domainList, result is "即可确认域名白名单问题。
隐私api：在调用一些敏感API（如chooseLocation、getLocation、choosePoi等），并且在控制台配置了应用和小程序相关权限管理，若出现“PluginEngine |eventName(chooseLocation) fail. no permission”相关报错，则是需要对小程序打开对应的权限。
﻿
﻿
﻿