• 0
  • 0
分享
  • Apifox IDEA 插件 | 帮助开发者快速生成 API 文档!
  • Apifox 2023-02-20 15:27:19 字数 1491 阅读 1878 收藏 0

Apifox 已推出 IDEA 插件 「Apifox Helper」 。Apifox Helper 是一款集成在 IDEA 中,帮助开发者自动解析代码注解并快速生成 API 文档的便捷工具。 Apifox Helper 是基于 javadoc(Java)、KDoc(Kotlin)、ScalaDoc(Scala)解析 API 文档,支持 Spring Boot、Swagger、JAX-RS 等协议框架,基本可以实现代码零入侵自动生成接口文档。

1.png

在 IDEA 中使用 Apifox Helper 可以一键同步文档到 Apifox 项目中,开发者无需切换工具,即可更新同步文档给团队内其他人员。自动解析注解、快速同步文档、IDEA 内调试、Apifox 便捷团队协作,你只需一个「Apifox Helper」。

接下来给大家演示如何使用。

安装 & 配置

首先,需要在 IntelliJ IDEA 安装并且配置令牌。打开 Preferences(Settings) > Plugins ,搜索 Apifox Helper 点击安装即可。

你也可以从 Jetbrains Marketplace 的官网下载安装。

2.png

安装成功后,要将 IDEA 内的项目与 Apifox 的项目进相关联,需要配置令牌。进入设置界面 Preferences(Settings) > Apifox Helper 中填写 Apifox 服务器地址、个人访问令牌、项目 ID:

Apifox 服务器地址:默认 Apifox API 服务地址为 *https://api.apifox.cn*,无需修改。

Apifox 个人访问令牌:在 Apifox 个人头像处的「账号设置 --> API 访问令牌」,新建令牌后复制生成的 Token 填写即可。

模块项目 ID 配置:这项主要是进行代码模块名和项目 ID 的映射关系配置,在 Apifox 中进入项目中「项目设置 --> 基本设置」,复制项目 ID 粘贴过来。

3.png

完成以上配置操作,就可以实现文档自动生成、同步、在线调试、导入导出等功能了。

自动生成 API 文档

使用「Apifox Helper」可直接自动解析代码注解,代码零入侵。右键点击「 Upload to Apifox」即可生成完整的 API 文档并同步到 Apifox 项目中 ,无需导出操作。团队成员即可在 Apifox 项目中完成接口调试、自动化测试等工作。

4.png

接口信息一键更新同步

当在 IDEA 项目中有接口信息变动,只需右键点击「 Upload to Apifox」一键即可完成同步, 无需奔走相告。团队成员可在 Apifox 中看到同步后的最新内容。

5.png

此外,使用 Apifox Helper 可以在 IDEA 中一键发起接口内测,同时支持导出 Markdown 格式文档和 cURL,适应不同团队的协作方式。

结合 IDEA 插件,我们推荐代码先行的团队 API 协作实践方式如下:

后端开发者:在 IDEA 中安装 「Apifox Helper」,随时编写/调试,随时更新同步;

前端开发者:在 Apifox 中查看最新文档,进行接口调试、API Mock ;

测试工程师:在 Apifox 中获取最新接口信息,编写/保存测试用例、进行自动化测试。

让后端开发者只需一个「Apifox Helper」即可在 IDEA 中完成 API 协作所需的工作。

6.png

现在出发,在 IDEA 内 「plugin」入口搜索「Apifox Helper」下载试试吧!

想了解更多关于插件的内容可以前往 Apifox 官方帮助文档查看:apifox.cn


  • 【留下美好印记】
    赞赏支持
登录 后发表评论
+ 关注

热门文章

    最新讲堂

      • 推荐阅读
      • 换一换
          • 一、功能测试用例的设计举例:(一)我想要回家,让你给我买一张票,然后设计测试用例答案:确定需求(回家回哪,需要什么票,买什么时候的票)开始测试功能测试(我去买票(买火车票,飞机票),买到票(什么时候),回来给你);可靠性测试(我去买票过程中被撞死了,票买不到怎么办,延期了,买那个点的票没了怎么办让我帮他买票的人的身份,比如是否有特殊优待,如军人,1米2以下儿童等,身份证丢了,或者票丢了,责任划分);可维护性测试(票是否可保存完好);兼容性(还不同人的去买,我中间招人去买,我坐车走路);算法测试(我通过不同的渠道买票花费的时间);竞品测试(别的人怎么买的票);安全性测试(身份信息保密);性能测试...
            0 0 1636
            分享
          •   在PC上调试HTML页面时,经常用到firefox上的firebug和chrome上的DevTools,这两个工具帮助开发和测试在debug问题上提供了很大的便利。在当下移动互联网热的时代,无线端的HTML5的产品越来越多,面对纷繁复杂的浏览器环境(搜狗浏览器,chrome,手机自带,app等等),经常遇到一些诡异的问题,在定位问题时令开发和测试束手无策。那么在移动端,是否也有这样好用的工具呢?接下来为各位简要介绍两个好用的工具。  在介绍之前,先简要说明一下,当前无线开发同学调试无线页面的过程。目前常用的方法是在chrome上设置移动UA,模拟移动设备。这种方式的好处是显而易见的,在PC...
            0 0 2435
            分享
          • Monkey介绍通过Monkey程序模拟用户触摸屏幕,滑动Trackball,按键等操作来对设备上的程序进行压力测试,检测程序错就的时间会发生异常Monkey用来做什么Monkey主要用于Android的压力测试,自动的一个压力测试小工具,主要目的就是为了测试app是否会Crash(崩溃)Monkey程序介绍(1) Monkey程序由Android系统自带,使用Java语言写成,在Android文件系统中的存放路径是: /system/framework/monkey.jar(2) Monkey.jar程序是由一个名为“monkey”的Shell脚本来启动执行,shell脚本在Android文...
            13 13 3806
            分享
          •   每次需求一出bug,不管最后追责杀到谁的头上,前边一定是产品刚在第一线。为了少出事,就在测试阶段多干活。  建议不管有多忙,产品也要在需求上线前验一遍。这样至少有两个好处:  ·少背锅。需求上线前,什么事情都比较好解决,比上线后扯皮强。  ·多露脸。部门那么大,不一定都认识,行走江湖靠朋友,各部门混个脸熟才是正道。  在不看触代码和接口,仅看功能逻辑的测试,就是黑盒测试。  那末,从产品的角度,黑盒测试该如何编写用例,才显得比较专业呢?  STEP1 改造测试的测试用例  找测试要一份测试用例文档,有些公司还会要求开测试用例评审会。  假如要不到,网上也能百度搜下来一份,然后删掉一些测试部...
            0 0 2422
            分享
          • 前言这几年关于“35岁失业”的讨论甚嚣尘上,特别是进入疫情时代,身边也越来越多的人开始讨论这个话题。一方面是疫情带来的巨大变革,导致部分行业特别是互联网大规模的裁员潮;另一方面,舆论里占据重要部分的也大多是互联网相关从业者;摸鱼、躺平等词语越来越成为了高频的社交讨论内容。今年步入30岁的年纪,对“35岁失业”有了不一样的感受。正好前天和一个原来的同事聊到了成长的瓶颈,以及寻求可能性的话题。这篇文章,聊聊我对“35岁失业”背后的原因分析,及个人的一些观点,包括我是如何应对“职业危机”的。如何理解35岁失业?网络上热议的“35岁失业”,最初应该是某互联网大厂的一个爆料引起的,然后近几年的互联网裁员...
            12 12 1929
            分享
      • 51testing软件测试圈微信