Android Studio & IDEA工程文档编写

1,917 阅读2分钟

不知道大家有没有这样的需求:项目工程想规范化,有一些关键类的说明文档;或者刚接手了一个不堪入目,没有注释的工程,每次找一些关键类的时候,总是靠记忆或者其他笔记去打开。

今天在梳理接手的工程时候,想让写一个ReadMe文档,并且可以跳转打开一些文件,比如某些关键类。先看效果: ReadMe跳转效果

这个效果很大地满足了我的需求。为了达到这个效果,需要具备2个知识点:

  1. Markdown语法: 不了解同学的可以百度下,不到10分钟你就可以成为一个Markdown入门选手
  2. 跳转文件链接的配置

Markdown配置与语法

  1. 安装Markdown插件:Preferences→Plugins->Marketplace→安装Markdown插件,重启Android Studio
  2. 在工程目录中适当的位置创建以"README.md"文件(以md结尾的Markdown文件即可)
  3. 复制下面这段md,按住Ctrl + 鼠标左键 or Command + 鼠标左键,即可跳转打开指定的文件,包括文件夹

[测试](build.gradle)

Markdown基础语法:

  1. #代表着标题,几个#代表这个几级的标题
  2. [显示的文本](跳转的链接):中拓号用于显示预览的文本,括号内是链接地址,可以网址,也可以是本文中的文件地址

上文动图,可以参考本人GitHub工程

文件引用路径的生成

上面动图使用到的文件路径[app/src/main/java/com/ben/template/XApplication.kt],有一定的规则:必须是从项目的根目录作为起始路径,而不是在电脑系统中的绝对路径。所以这里要使用一个命令:Path From Respository Root,可以通过以下2个方式去找到

  1. 菜单栏→Edit→Copy找到
  2. 设置项Preferences→Keymap→直接搜索并添加快捷键

其他

  1. Markdown推荐编辑器:马克飞象 这个编辑器是我入坑Markdown以来一直在用的,渲染效果好,可以导出pdf、md、html。
  2. Android Studio上还可以通过Favorites面板来保存需要的文件,也可以通过书签Bookmarks来保存,有相应的快捷键

GitHub工程