V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
whitecosm0s
V2EX  ›  分享创造

[MacOS APP] 可能是 Mac 上颜值最高的接口文档生成工具

  •  
  •   whitecosm0s · 2020-10-11 06:08:30 +08:00 · 2750 次点击
    这是一个创建于 1265 天前的主题,其中的信息可能已经有所发展或是发生改变。
    4 条回复    2020-10-11 11:01:47 +08:00
    whitecosm0s
        1
    whitecosm0s  
    OP
       2020-10-11 06:25:26 +08:00
    大家好,RabiAPI 原本是我上班时开发的一个内部服务,用于自动生成各种微服务项目的接口文档,现在我把它做成了一个独立的,完全离线使用的 MacOS App 。

    由于公司里用的是自研的微服务框架,所以 Swagger 这类框架无法直接使用,Javadoc 对于前端是基本看不懂的,作为后端也不愿意使用 YAPI 这种类似填 Excel 表格的工具,因为微服务一个接口上百个字段非常普遍,这是我当时开发这个工具的主要原因。

    这个工具的原理是通过静态分析扫描源代码并分析语法结构,提取可以生成文档的部分,例如 javadoc 注释,框架相关的注解等等,生成文档前不需要构建和编译,也不需要配置任何东西。

    项目介绍: https://github.com/RabiAPI/RabiAPI-Support

    ## 支持的框架和注解

    - Java Interface
    - Spring Boot 注解
    - Jax-RS 注解
    - Swagger 2.0 注解

    ## 支持的导出格式

    - markdown
    - asciidoc
    - PNG 图片

    ## 下载地址

    - [Mac App Store]( https://apps.apple.com/cn/app/id1524200727)

    ## 付费方式

    - 免费版本,最多同时使用三个项目
    - 按月订阅,¥12.00 / 每月,自动续期
    - 按年订阅,¥98.00 / 每年,自动续期

    ## 联系地址

    - QQ 产品交流群:244365684
    - 邮箱: [email protected]
    whitecosm0s
        2
    whitecosm0s  
    OP
       2020-10-11 06:26:46 +08:00
    第一次发帖,点击预览的时候不小心点到了创建,只好写在回复里了,抱歉。
    balabalaguguji
        3
    balabalaguguji  
       2020-10-11 09:19:11 +08:00
    何不试下易文档,专业做接口文档管理的 https://easydoc.top
    whitecosm0s
        4
    whitecosm0s  
    OP
       2020-10-11 11:01:47 +08:00
    @balabalaguguji 这个工具可以和所有 wiki 类的产品配合使用,把接口文档导出到 markdown 再复制上去,提高维护效率^_^
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   2795 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 28ms · UTC 11:54 · PVG 19:54 · LAX 04:54 · JFK 07:54
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.