daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
133 Commits 1 Branch 0 Tags
1d231a52efcb86f78371483c9a937efc3957ef67
Commit Graph
7 Commits
Author SHA1 Message Date
joywayer 1d231a52ef 4.B QQ 链接分享改 previewimagedata 内联 base64：修缩略图破图 
实测控制台 `unable to make sandbox extension: [1: Operation not permitted]`
证实 previewimageUrl=file://... 跨 app 沙盒无效 —— QQ 进程读不到调用方 app
tmp 目录里的文件，渲染破图占位。

msext 这段实现一直是装饰性代码（线上同样破图但没人改）。新外壳按原则 B
现代化修正：

- 字段名改用 QQ Open SDK 实际约定的 `previewimagedata`（值=图像字节
  base64，而非 file path base64）
- 内容来源改用 app icon JPEG 0.6 编码后 base64 内联到 URL
- 删 writeAppIconToTemp（不再写临时文件）

App icon 60-180px JPEG 0.6 后 base64 约 5-15KB，iOS openURL ~64KB 限额下
余量充足。这条修正违反"原则 A 等价 msext"吗？不——契约 §3.1［2］
sharesuccess 反向 callback 已经在 commit 9bd5a81 落地，与 H5 唯一可见
的契约面（callback 时机与载荷）保持等价。msext 这处缩略图字段错写属于
原项目内部 bug，新外壳的"原则 B 内部自由重构"覆盖范围，按现代标准修正
不破契约。
 2026-06-24 18:45:05 +08:00
joywayer 2f3a35892b 4.B QQ 链接分享补 previewimageUrl：用 app icon 当缩略图 
QQ 会话里链接分享的缩略图位空白，因为 News 类型缺 previewimageUrl 字段。
对齐 msext QQShareManager.m:517-522 + 1271-1278 的写法：

1. app icon JPEG 0.7 写到 NSTemporaryDirectory()/qq_share_<UUID>.jpg
2. 拼 file://<path> 字符串
3. base64 后再 URL-encode
4. append &previewimageUrl=<那串>

writeAppIconToTemp() 与 appIconImage() 直接抄 WechatShare 同源策略（读
Info.plist CFBundleIcons → CFBundlePrimaryIcon → CFBundleIconFiles 最后
一个）。两处复制可接受 —— Share 模块统一缩略图工具可后续抽到
ImageProvider，本次保持改动范围最小。
 2026-06-24 18:03:58 +08:00
joywayer 34a336d859 4.B QQ 链接分享补齐 URL Scheme 全量参数：可弹好友选择面板 
【契约影响】§3.1［2］仅 native 实现细节，H5 无感

先前 QQShare.shareLink 只拼 version/cflag/req_type/url/title/description
6 个字段，QQ 客户端识别失败 → 只打开主页，不弹好友选择。对齐 msext
QQShareManager.shareToQQFriend:QQShareTypeNews URL Scheme fallback 路径
补齐：

- 公共参数：src_type=app / app_id / share_id / file_type=news /
  callback_type=scheme / callback_name=QQ<hex(appID,8)> /
  thirdAppDisplayName / app_name（后两者 base64+urlenc）
- 内容参数：News 类型 title/desc/url 必须 base64 后再 URL-encode（与
  msext line 513-515 一致）

新增常量（沿用 daoqi 注册值）：
  appID    = 102793577    （daoqi kQQAppID）
  appIDHex = 06208169     （callback_name 后缀，QQ 协议要求）
  appName  = 进贤聚友棋牌  （msext kQQAppName 同源）

Info.plist 增加 CFBundleURLSchemes tencent102793577 —— QQ 客户端识别
"调用者已在 Info.plist 注册 AppID"的前置条件，没这一项 QQ 直接拒绝弹
分享面板。

⚠️ AppID 102793577 在 QQ 互联开放平台绑给 com.chao.msext。新外壳 bundle
id com.skyapp.ylgamehall —— QQ 客户端唤起 UI 时实测大概率不严格校验，
但若后续遇到拒绝/回调失败，需到 https://connect.qq.com/ 重新注册 AppID
绑给新 bundle id，只改 QQShare 顶部 3 个常量 + Info.plist 即可。

截图分享（type==2）保持剪贴板 + 引导框模式 —— URL Scheme 内联 base64
1080p 截图编码后 URL ≈ 5MB，iOS openURL 不可靠。
 2026-06-24 17:49:23 +08:00
joywayer 68c668a06c 4.B 截图分享补齐 msext 字段：WeChat description / QQ 引导框 
【契约影响】docs/H5-Native-Contract.md §3.1［2］type==2 分支

WeChat 截图分享之前丢了 H5 description（msext 通过
sendImageData:MessageExt: 写到 WXMediaMessage.description，接收方在
微信聊天预览里能看到）。链接分享之前完全没传 thumb（msext 用 app
icon）。统一补齐：

- WeChatManager.ShareImage 加 messageExt / mediaTagName 字段；
  shareImage 内 message.description = messageExt + message.messageExt
  = messageExt + setThumbImage(thumb) + mediaTagName
- WeChatManager.ShareLink 把 thumbnailURL: String? 替换为 thumb:
  UIImage?；shareLink 内 setThumbImage(thumb) + mediaTagName。drop
  Sendable 因 UIImage 不可 Sendable（调用都在 MainActor 上无风险）
- WechatShare 双分支统一传 appIconImage() 做 thumb；截图分支 messageExt
  = content.desc + mediaTagName "进贤聚友棋牌游戏截图分享"；链接分支
  mediaTagName "进贤聚友棋牌游戏分享"（字面对齐 msext WechatShareManager.m）

QQ 截图分享原本 4-fallback URL 链不靠谱（file_type=news 给截图场景实际
无意义）。简化为 Douyin 同款模式：截图 → UIPasteboard.image → 弹"立即
打开 QQ / 稍后分享"二选一 Alert。承认 ADR-006 无 QQ SDK 退化的现实，
但 UX 不再让用户摸不着北。
 2026-06-24 07:53:14 +08:00
joywayer 9bd5a81e6c 4.B 分享逻辑对齐 daoqi msext：调用即触发 sharesuccess 
【契约影响】docs/H5-Native-Contract.md §3.1［2］/§3.2［11］

H5 端 sharesuccess 时机改为"调用 friendsShare handler 即立刻发"，与
原 msext 行为等价（live path 完全不等 SDK / URL Scheme 回包）。用户
明示有意为之：URL Scheme + 剪贴板路径本就没有可靠回包，乐观策略避免
H5 业务卡住。

3 平台分支严格 1:1 对齐 daoqi msext：

WechatShare（对齐 WechatShareManager shareWithContent）
  - type=="2" → 截图 JPEG 0.6 + sendImageData + app icon thumb
  - else      → 链接分享 sendLinkURL + app icon thumb
  - 移除原"远端图"分支（原项目无此分支）
  - 新增 appIconImage helper（读 Info.plist CFBundleIcons，对齐
    [self getAppIconImage]）

QQShare（对齐 QQShareManager shareWithContent + simpleShareToQQFriend）
  - type=="2" → 截图 → UIPasteboard.image → 4 URL Scheme fallback
  - else      → mqqapi://share/to_{fri,qzone}?req_type=1&url=...
                &title=...&description=...（webpageUrl 空时 req_type=0）
  - 不依赖 QQ SDK（CLAUDE.md ADR-006）

DouyinShare（对齐 DouyinShareManager shareWithContent）
  - type=="2" → 截图 → UIPasteboard.image → "立即打开抖音"引导框
  - else      → title+"\n\n"+desc → UIPasteboard.string → 引导框
                双侧空时兜底 "来自进贤聚友棋牌的精彩内容分享"
  - 放弃之前的"存相册 + 自动拉起"激进路径，回到原项目"用户主动点"路径

架构调整：
- SharePlatform.share 改 sync fire-and-forget（去 ShareResult 返回）
- ShareCenter.dispatch / SharePanel.show 去 completion 参数
- FriendsShareHandler：解析后先发 responseCallback("sharefriend")
  与 sharesuccess({success:"2", type:<sharefriend>})，再异步 dispatch
 2026-06-24 07:34:03 +08:00
joywayerandClaude Opus 4.7 aff5ee7633 Phase 4.C：QQShare URL Scheme 真实落地（不依赖 SDK） 
移植 msext QQShareManager.m:716-771 simpleShareToQQFriend 简化版到 Swift。

QQShare.share 完整实现：
  - canOpenURL("mqqapi://") 检测 QQ 安装；未装返回 .notInstalled
  - 仅链接分享走完整 URL Scheme（type == "1"）；type == "2"/其它（截图 /
    远端图）暂返回 .success 避免 H5 业务卡住，Phase 4.F 接入
  - URL 构造（与 msext 等价）：
    * scene == .timeline → mqqapi://share/to_qzone? （QQ 空间）
    * scene == .friend   → mqqapi://share/to_fri?   （QQ 好友）
    * 参数：version=1 + cflag=0 + req_type=1（无 url 时 req_type=0）+
      url=<encoded> + title=<encoded> + description=<encoded>
  - encode 函数与 msext QQShareManager.m:1262-1268 等价：仅保留 RFC 3986
    unreserved 字符（alphanumeric + "-._~"），其它全部 percent encode
  - canOpenURL 二次检查 + await UIApplication.open
  - 调起即视为 success（msext 同款乐观策略，URL Scheme 单向无返回）

Info.plist 新增 LSApplicationQueriesSchemes（iOS 9+ canOpenURL 白名单
要求，否则总返回 false）：
  - mqq / mqqapi / mqqopensdkfriend / mqqopensdkapiV2/V3/V4（QQ 相关）
  - snssdk1128（抖音，Phase 4.D 用）
  - 微信相关待 Phase 4.E 接入 SDK 时再加（weixin / weixinULAPI 等）

BuildProject 通过

Plan §5 Phase 4.3 勾选

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 20:04:36 +08:00
joywayerandClaude Opus 4.7 2ad4563d16 Phase 4.B：SharePlatform 框架 + SharePanel 三选一 UI + ShareCenter 分发 
按 msext gameController.m:575-597 / SharePanel.m 模式落地分享框架。

新增 Source/Share/：
  - SharePlatform.swift：
    * SharePlatform 协议（name / isInstalled / share async → ShareResult）
    * ShareContent struct（nonisolated Sendable，6 字段 sharefriend/sharetype/
      type/webpageUrl/title/desc）
    * ShareResult enum (success / cancelled / notInstalled / failed)
    * ShareScene enum (friend / timeline)
  - SharePanel.swift：
    * @MainActor UIView，半透明黑底覆盖全屏 + 底部圆角内容视图滑入
    * 三按钮（微信绿 / QQ 蓝 / 抖音黑）+ label 等间距居中布局
    * 已安装平台按钮高亮，未装置灰
    * 点击空白区 dismiss + completion(.cancelled)
    * 点击按钮 dismiss + 触发对应 SharePlatform.share + completion(result)
    * 0.25s 滑入/滑出动画
    * 与 msext SharePanel.m 等价行为
  - ShareCenter.swift：
    * sharefriend == "1" → SharePanel.show 三选一
    * sharefriend == "2" → WechatShare.share scene: .timeline 朋友圈
    * 与 msext gameController.m:585 行为 1:1
  - WechatShare.swift：stub（Phase 4.E 等微信 SDK 接入）
  - QQShare.swift：stub + canOpenURL("mqqapi://") 检测（Phase 4.C 升级
    URL Scheme 真实调起）
  - DouyinShare.swift：stub + canOpenURL("snssdk1128://") 检测（Phase 4.D 升级
    URL Scheme + Photos）

FriendsShareHandler 升级：
  - 入参解析为 ShareContent
  - 调 ShareCenter.dispatch
  - completion 内根据 result 触发 sharesuccess 反向 callback：
    * success / cancelled → bridge.call("sharesuccess", {success:"2", type:sharefriend})
    * notInstalled / failed → 不发（H5 业务期 timeout 后自行 fallback，msext 乐观策略）

ShareContent 标 nonisolated 解 Swift 6 actor 隔离（项目默认 MainActor isolation
让 struct 跨 actor 受限）。

BuildProject 通过

Plan §5 Phase 4.2 勾选

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 20:02:34 +08:00