[对接文档] 增强，支持对接文档生成与扩展，包括文本文档生成、联调代码生成 ...等

[iohao]

新增功能的使用场景

新增 IoGameDocumentHelper ，用于代替 BarSkeletonDoc 。

IoGameDocumentHelper 在使用上更简单、强大。

示例代替

public static void main(String[] args) {
    // 添加枚举错误码 class，用于生成错误码相关信息
    IoGameDocumentHelper.addErrorCodeClass(GameCode.class);

    // 添加文档生成器，文本文档
    IoGameDocumentHelper.addDocumentGenerate(new TextDocumentGenerate());
    // 添加文档生成器，Ts 联调代码生成
    IoGameDocumentHelper.addDocumentGenerate(new TypeScriptDocumentGenerate());
    // 生成文档
    IoGameDocumentHelper.generateDocument();
}

上述代码

• 添加了错误码的生成
• 添加了文本文档的生成
• 添加了 Ts 客户端联调代码的生成（包括 action、广播、错误码...相关代码的生成）， #329

addDocumentGenerate 是可扩展的，这将意味着开发者可以扩展出 C#、GodotScript、Js ...等不同客户端的联调代码。默认，我们提供了一个文本文档，即 TextDocumentGenerate，如果默认的实现满足不了当下需求，开发者也可以定制个性化的文档，如 json 格式的。

更多内容请阅读 游戏对接文档生成 (yuque.com)

[iohao]

框架已经提供了相关扩展接口 DocumentGenerate，开发者可以扩展此接口来定制更多个性化的扩展，如

• html 版本的文档。
• json 版本的文档。
• 其他语言的联调文档 ...等。

/**
 * 对接文档生成接口，可扩展不同的实现
 */
public interface DocumentGenerate {
    /**
     * 生成文档
     *
     * @param ioGameDocument ioGameDocument
     */
    void generate(IoGameDocument ioGameDocument);
}

// 使用示例
private static void test() {
    var documentGenerate = new YourDocumentGenerate();
    IoGameDocumentHelper.addDocumentGenerate(documentGenerate);
}