joywayer
5b38456c66
为支撑 H5 的 prepareaudio / mediaTypeAudio 录音上传 + 远端语音播放
（docs/H5-Native-Contract.md §3.1 ［4］［5］ + §3.2 ［9］）接入 AMR-NB
编解码能力。AMR-NB 是跨端（iOS / Android / 旧版本客户端）契约硬约束，
不可换 AAC / Opus。
## 接入路径
直接 vendor daoqi msext 现成的 fat .a（已上线多年），不打 xcframework /
不重编源码：
- Vendor/OpenCoreAMR/v0.1.x/libopencore-amrnb.a：daoqi 同款 5-slice fat
库（含 2026-06-20 lipo -segalign 8 修过的对齐版本）
- Vendor/OpenCoreAMR/v0.1.x/{interf_dec,interf_enc}.h：amrnb 公开头
- Vendor/OpenCoreAMR/README.md：来源、版本、修复历史、为何不打 xcframework
- ylgamehall/Source/Audio/AMRFileCodec/{amrFileCodec.h,amrFileCodec.mm}：
daoqi 同款 wrapper（文件级 WAV↔AMR 处理）
- ylgamehall/Source/Audio/AMRCodec.swift：Swift 薄 wrapper（wavToAmr /
amrToWav 两个纯函数 + AMRCodec.Error）
理由见 Vendor/OpenCoreAMR/README.md「为何不打 xcframework / 不重编源码」
一节，本质是 opencore-amr 整个 iOS 生态没有"现代主流"分发形态，社区无
官方 SPM / xcframework 维护，强行打反而引入新风险。
## 关键技术点：extern "C" 修复 ObjC++ name mangling
amrFileCodec.h 在原项目里没有 extern "C" 包裹函数声明，daoqi 能跑是
因为调用方 VoiceConverter.mm 也是 ObjC++，双方按相同 C++ name mangling
链接能对上。
新外壳从 Swift 通过 bridging-header 调用，Swift 按 C 函数解析，期望符号
_EncodeWAVEFileToAMRFile / _DecodeWAVEFileToWAVEFile（C 链接）；但
.mm 编译时默认 C++ name mangling，符号变成 __Z25Encode...，导致链接器
报 Undefined symbol。
修复：在 amrFileCodec.h 的函数声明外加 #ifdef __cplusplus / extern "C"
包裹。这是标准 C/C++ 头文件兼容写法，对 daoqi 老路径无影响（ObjC++
调用方仍能链接 C-linkage 函数）。
## .gitignore：白名单 Vendor 下的 .a
发现历史遗留问题：原 .gitignore *.a 通配规则把 libWeChatSDK.a 也排除
了，意味着别人 clone 此仓库后链接失败。本次顺带修复：
!Vendor/**/*.a
让 Vendor 下的 .a 显式纳入跟踪。本提交同时把 libWeChatSDK.a（历史
缺失）+ libopencore-amrnb.a（本次新增）一并加入 git 跟踪。
## 工程改动
pbxproj 改动由用户在 Xcode UI 完成（4 项 Build Settings：Add .a 到
Frameworks group / Header Search Paths +2 / Library Search Paths +1；
EXCLUDED_ARCHS arm64-simulator 因真机调试场景暂未配，需要时再加）。
## 验证
BuildProject 通过，0 错误，符号链接正确。XcodeRefreshCodeIssuesInFile
对 AMRCodec.swift 0 诊断。
重要! SDK1.8.2 1. SDK增加开发票授权 WXInvoiceAuthInsert 2. SDK增加非税接口 WXNontaxPay 3. SDK增加医保接口 WXPayInsurance 4. 更换MTA库 SDK1.8.1 1. SDK打开小程序支持指定版本（体验，开发，正式版） 2. SDK分享小程序支持指定版本（体验，开发，正式版） 3. SDK支持输出log日志 SDK1.8.0 1. SDK支持打开小程序 2. SDK分享小程序支持shareTicket SDK1.7.9 1. SDK订阅一次性消息 SDK1.7.8 1 SDK分享小程序支持大图 SDK1.7.7 1 增加SDK分享小程序 2 增加选择发票接口 SDK1.7.6 1. 提高稳定性 1 修复mta崩溃 2 新增接口支持开发者关闭mta数据统计上报 SDK1.7.5 1. 提高稳定性 2. 加快registerApp接口启动速度 SDK1.7.4 1. 更新支持iOS启用 ATS(App Transport Security) 2. 需要在工程中链接CFNetwork.framework 3. 在工程配置中的”Other Linker Flags”中加入”-Objc -all_load” SDK1.7.3 1. 增强稳定性，适配iOS10 2. 修复小于32K的jpg格式缩略图设置失败的问题 SDK1.7.2 1. 修复因CTTeleponyNetworkInfo引起的崩溃问题 SDK1.7.1 1. 支持兼容ipv6(提升稳定性) 2. xCode Version 7.3.1 (7D1014) 编译 SDK1.7 1. 支持兼容ipv6 2. 修复若干问题增强稳定性 SDK1.6.3 1. xCode7.2 构建的sdk包。 2. 请使用xCode7.2进行编译。 3. 需要在Build Phases中Link Security.framework 4. 修复若干小问题。 SDK1.6.2 1、xCode7.1 构建的sdk包 2、请使用xCode7.1进行编译 SDK1.6.1 1、修复armv7s下,bitcode可能编译不过 2、解决warning SDK1.6 1、iOS 9系统策略更新，限制了http协议的访问，此外应用需要在“Info.plist”中将要使用的URL Schemes列为白名单，才可正常检查其他应用是否安装。 受此影响，当你的应用在iOS 9中需要使用微信SDK的相关能力（分享、收藏、支付、登录等）时，需要在“Info.plist”里增加如下代码： <key>LSApplicationQueriesSchemes</key> <array> <string>weixin</string> </array> <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict> 2、开发者需要在工程中链接上 CoreTelephony.framework 3、解决bitcode编译不过问题 SDK1.5 1、废弃safeSendReq:接口，使用sendReq:即可。 2、新增+(BOOL) sendAuthReq:(SendAuthReq*) req viewController : (UIViewController*) viewController delegate:(id<WXApiDelegate>) delegate; 支持未安装微信情况下Auth,具体见WXApi.h接口描述 3、微信开放平台新增了微信模块用户统计功能，便于开发者统计微信功能模块的用户使用和活跃情况。开发者需要在工程中链接上:SystemConfiguration.framework,libz.dylib,libsqlite3.0.dylib。