《Cocos 游戏开发高级编程》8.2 原生插件与三方 SDK 接入
把《方块冲刺》接一个三方 SDK 的完整链路走一遍：先看 Android/iOS 原生工程里插件该落在哪，再分别写 Java 与 Objective-C 桥接类，然后用 TypeScript 门面包一层平台适配，让业务代码只见接口不见平台；重点讲清原生结果回传给 JS 时的线程约束、回调注册与生命周期坑，最后算一笔插件维护成本的账。
category
Cocos
共 180 篇文章。
《Cocos 游戏开发高级编程》8.1 原生平台与 JSB
从原生构建产物入手，讲清 Cocos Creator 3.8 在 Android/iOS 上如何把 JS 引擎嵌进 C++ 宿主，JSB 绑定怎样把 cc 的类暴露给脚本层；用 cc.d.ts 实测划出「平台无关 API」与「原生运行时注入对象」的边界，讲对 sys.isNative 与 sys.platform 的用法，量化反射式原生调用的成本，给出下沉原生的工程判断。
《Cocos 游戏开发高级编程》7.3 性能剖析与优化闭环
卷二 13.3 讲清了帧预算四段与 Profiler 面板怎么开。本节把它升成一个可重复的闭环：采样、定位、修复、验证，每一步给出 cc.d.ts 能证明的 API，并用纯 TS 写一个带分位数的帧时间采样器配 vitest 断言。核心纪律是先量再改、一次只改一处、改完同设备复测。
《Cocos 游戏开发高级编程》7.2 纹理、显存与资源预算
7.1 说明资源内存在引擎与 GPU 侧、不归 GC 管。本节把这笔账算细：落到 cc.d.ts 里的 PixelFormat 与 gfx.Format 两套枚举，把块压缩对齐与 mipmap 的 1.33 倍写进公式，用纯 TS 写一个可单测的显存计算函数，并给出整包资源预算表与读取真实显存的 API。
《Cocos 游戏开发高级编程》7.1 内存模型与 GC
卷二 13.2 算过纹理内存、也定了引用计数纪律，但没回答字节到底躺在哪、Asset 从加载到消失经历了什么、GC 何时被触发。本节把 Cocos 运行时内存切成 JS 堆、原生堆与 GPU 显存三块，给出 Asset 生命周期与引用计数的 cc.d.ts 证据，并用纯 TS 写一个对象池加触发式回收模型，配 vitest 断言。
《Cocos 游戏开发高级编程》6.3 动画性能与内存
动画的代价分两块：CPU 每帧采样曲线并混合，内存里躺着关键帧数据、烘焙关节纹理与合批图集。本节算清这笔账，讲明采样率、烘焙、图集三者如何互相兑换，用纯 TS 写一个可单测分位数的帧耗时统计器，并给出《方块冲刺》这类项目能直接落地的动画预算清单与排查顺序。
《Cocos 游戏开发高级编程》6.2 骨骼动画与蒙皮
骨骼动画把动画数据从「节点属性」换成「几十上百个关节的变换矩阵」。本节讲清 Skeleton 资源里的 joints 与 bindposes、SkeletalAnimation 的烘焙开关、蒙皮顶点的加权计算，以及蒙皮模型为什么难以合批、SkinnedMeshBatchRenderer 又如何把共享骨骼的模型合并。
《Cocos 游戏开发高级编程》6.1 动画系统内部与求值
Cocos 动画由 AnimationClip 的 track/channel/curve 三层数据驱动，AnimationState 按时间采样并混合出当前姿态。本节拆开整条求值链路：关键帧插值、weight 混合、crossFade 过渡，用纯 TS 写一个可单测的关键帧求值器，并核对事件常量到底挂在哪个类上。
《Cocos 游戏开发高级编程》5.3 自定义碰撞与查询
讲清 Cocos 2D 物理的主动查询与自定义碰撞响应：用 PhysicsSystem2D.instance 的 raycast、testPoint、testAABB 做射线与区域查询，用 Contact2DType 的四个回调写自定义响应，并指出 IPhysics2DContact 的字段是 colliderA/colliderB 而非 selfCollider/otherCollider。
《Cocos 游戏开发高级编程》5.2 物理调试与性能
讲清 Cocos 2D 物理的可观测性：用 PhysicsSystem2D 的 debugDrawFlags 与 EPhysics2DDrawFlags 位掩码把物理世界画出来，理解 fixedTimeStep、maxSubSteps、autoSimulation 与求解器迭代参数的语义，并用 profiler.stats.physics 定位物理帧开销，附可单测的固定步长累加器实现。
《Cocos 游戏开发高级编程》5.1 内置物理与 Box2D 后端
从 cc.d.ts 与引擎源码路径实证 Cocos 2D 物理的两套后端：内置 builtin 与 Box2D，讲清 PhysicsSystem2D 的后端选择、PHYSICS_2D_PTM_RATIO 单位换算、刚体类型与碰撞体家族，以及两套后端在碰撞回调与动力学上的能力差异，最后落到工程选型。
《Cocos 游戏开发高级编程》目录
《Cocos 游戏开发高级编程》全书导航页：说明本卷定位与读者画像、前置知识、三条阅读路径与八周排期，交代贯穿项目《方块冲刺》在卷三里的深化方向与引擎源码引用口径，讲清 L2/L3/L0 三层的可验证边界，并按四个部分列出 11 章 33 节的完整章节索引与常见问题速查表，方便按需定位与跳读。
《Cocos 游戏开发高级编程》4.3 自定义装配与渲染纹理
RenderTexture 是把渲染结果搬进一张纹理的载体。本节从 cc.d.ts 与引擎源码实证它的能力边界，讲清用 Camera.targetTexture 做离屏渲染、用自定义 Effect 做镜像、用 readPixels 做截图，并给出尺寸上限、坐标系与复用等实战陷阱。
《Cocos 游戏开发高级编程》4.2 阴影与光照贴图
光被挡住怎么办、光能不能提前算好？本节讲 2D 阴影的两条实现路线——投影剪影与阴影贴图，怎样用 RenderTexture 承载一个专用阴影相机，以及把光提前烘进贴图的预烘焙做法，并附一个可单测的烘焙器骨架、动态阴影与预烘焙的取舍表和工程决策清单。
《Cocos 游戏开发高级编程》4.1 2D 光照与法线
Cocos Creator 3.8 的 cc.d.ts 里其实没有 Light2D——2D 光照在引擎里不是一个组件，而是一个着色器问题。本节先用 grep 证伪，再讲清法线贴图与 Lambert 漫反射的直觉，最后给出可直接单测的纯 TS 光照算法、把光参数喂给材质的组件，以及一个自定义 .effect。
《Cocos 游戏开发高级编程》3.3 后处理与全屏特效
后处理是把整帧渲染结果当输入纹理再算一遍。本节讲清 Cocos 3.8 的 PostProcess 与 BlitScreen 框架、如何写一个全屏灰度 Effect、如何在编辑器里搭起后处理链，并给出可编译的装载代码；同时算清全屏带宽、shadingScale 与多 pass 泛光的性能代价。
《Cocos 游戏开发高级编程》3.2 改造内置着色器
上一节读了 Effect 语法，这一节动真格：把内置 sprite 着色器复制出来，改出一条描边。本节给出改前与改后的完整可读片段，逐段解释 texel 计算、邻域采样与 alpha 判据，再给出可编译的材质装载代码，并说清五次采样的性能代价与合批影响。
《Cocos 游戏开发高级编程》3.1 Cocos Effect 语法与编译
Effect 文件是 Cocos 渲染定制的入口。本节拆开它的两半——描述管线与属性的 CCEffect 块、写 GLSL 的 CCProgram 块，逐段解读内置 sprite 着色器，讲清从 Effect 源码到 EffectAsset、Material、Pass 与 Shader 变体的编译链路，并给出可编译的材质初始化与宏切换代码。
《Cocos 游戏开发高级编程》2.3 渲染批次与合批机制
卷二 13.1 把《方块冲刺》主场景的 Draw Call 从 180 压到 42，用的是自动图集与层级排序。这一节把那次优化从 Batcher2D 内部解释清楚：遍历怎么走、合批靠什么哈希判定、顶点容量由哪个宏控制、以及 180 到 42 的差额具体来自哪几条被消掉的打断条件。所有结论都对照 cc.d.ts 与 cocos-engine 3.8.8 源码。
《Cocos 游戏开发高级编程》2.2 材质与 Effect 体系
EffectAsset、Material、Pass 是 Cocos 渲染里最容易被混为一谈的三样东西。这一节把它们的关系拆清楚：谁是模板、谁是配置、谁是真正提交 GPU 的单位，再用 cc.d.ts 与 cocos-engine 3.8.8 源码追一遍 setProperty 的调用链，最后给出改材质、改单个节点材质、每帧改 uniform 三种场景的正确写法与代价。