参与开发

参与文档开发

期待您也能和我们一起参与到文档的完善中,参与方法:

  • Fork 文档仓库 cocos2d-x-docs
  • en/ 目录对应英文文档, zh/ 目录对应中文文档。
  • 代码块要以一种特殊的方式包裹,例如 C++ 代码块:

    • 包裹方法:

 参与开发  - 图1

  • 最终效果:

C++

auto mySprite = Sprite::create("mysprite.png", Rect(0,0,40,40));

  • 使用 gitbook serve 命令测试改动在 GitBook 中的效果

  • 提交 pull request 到 cocos2d/cocos2d-x-docs 仓库

  • 我们会 review 这个 pull request 并 merge

    参与引擎开发

使用 Cocos2d-x 的过程中,对于一般的问题,欢迎通过 论坛 向我们反馈。对于明确是 BUG 的,请参照下述方法反馈。

反馈 BUG

在 Cocos2d-x 的使用过程中,遇到 BUG 可以通过下面的方式在 GitHub 上向我们反馈。

  • 新建 Cocos2d-x 的 Issues,传送门

  • 增加一些必要的信息,帮助开发者定位修复 BUG

    • BUG 出现的环境,
      • Cocos2d-x 的版本,如 3.16
      • 使用的 IDE,如 Xcode 8.3.3
      • 测试设备,如 iPhone 7
    • BUG 的重现步骤
    • 如果有和 BUG 相关的其它信息,也可以一并提交,如 资源链接

      贡献代码

Cocos2d-x 在 GitHub 开源,你可以通过下面的方式贡献自己的代码,成为 Cocos2d-x 的贡献者。

  • 从 GitHub 克隆最新的开发分支到本地

    1. git clone git://github.com/cocos2d/cocos2d-x.git
    2. cd cocos2d-x
    3. git checkout v3
    4. ./download-deps.py
    5. git submodule update --init
  • 把代码改动添加到最新的开发分支

  • 将改动提交到自己的代码仓库中
  • 为本次代码提交创建一个新分支 如:$ git checkout -b my_fix_branch
  • push 新分支到自己的 GitHub 公共仓库
  • 创建一个 Pull request 给 cocos2d/cocos2d-x
  • 改动一定要完善,并且符合发布规则,参考下面:

    补丁要求

  • C++ 代码遵循 代码风格

  • Python 代码遵循 代码风格
  • 描述补丁的功能
  • 包括测试用例(如果适用)
  • 包括单元测试(如果适用)
  • 必须在所有支持的平台上进行测试 [*]
  • 不得降低性能
  • 不得破坏现有测试用例
  • 不得破坏持续集成的构建
  • 不能破坏向后的兼容性
  • 编译必须无错误,无告警
  • 新的 API 必须易于使用
  • 代码必须易于扩展和维护
  • C ++ API 需要按照 Doxygen 注释规范注释
  • 必须有一个描述如何使用该工具的 README.md 文件(补丁是工具)
  • 必须高效(快/低内存需求)
  • 不能重复现有的代码
  • 重构关键组件的补丁只能在下一个主要版本中合并
    [*]:如果您无法在所有支持的平台中测试代码,请告知我们。

宣传 Cocos2d-x

当您使用 Cocos2d-x 开发了游戏,希望您能将 Cocos2d-x 的 Logo 放到游戏中,或者把 Cocos2d-x 加到致谢中。让我们一起提高 Cocos2d-x 的知名度,让更多的人参与到 Cocos 开源社区的建设中。

Cocos2d-x Logo 资源

原文: http://docs.cocos.com/cocos2d-x/manual/zh/about/how.html