Kotlin-为Android项目生成Doc文档

类似于Java中的JavaDoc工具，Kotlin的官方也发布了一款生成Kotlin文档工具。 dokka

不过它确实不是很好用。

坑1：截止在我写这边文档时候，该工具的最新版本为0.10.0。在这辩正庆个版本中清简，作者将两个插件进行了合并（一个适用于Android项目的插件，一个则用于通用Kotlin项目插件）。导致了出现了一个大坑。详情请见这里 [ https://github.com/Kotlin/dokka/issues/213(https://github.com/Kotlin/dokka/issues/213) 。

经过一早上的踩坑折腾，发现在回退到上一个版本，0.9.17版本没出现类似问题。

然后同步项目之后，该插件会为项目添加一个dokka的task。

坑3：GC overhead limit exceeded。解决了上一个问题，又出现了一个oom的问题。这个问题也算是常见，不过我这个总共不超过十个class文件，居然翻车了。。好吧，果断在根目录下gradle.properties文件中配置扩大一下堆栈大小

在成功构建完所有的构建变体任务后，终于看到了在输出目录 outputDirectory 中的出现了javadoc文件夹。

打开index页面，你就可以看到dokka为项目生成的文档了。

在以上声明中，dokka就不会为androidx作为包名前缀的类生成文档。问题似乎得到了解决。但是这是一种舍近求远的方法。就好比你去一家店想买一杯奶茶，老板居然问你不想喝什么口味的。携握。因为在后续的开发中你可能还会引入新的包，dokka可能会为其他R文件生成以其他报名开头的文档。那么此时你必须继续添加packageOptions配置。。

如果我们做一个小型的web站，而且刚袜团好选择的kotlin 和Spring Boot技术栈，那么上传文件的必不可少了，当然，如果你做一个中大告孝橘型的web站，那建议你使用云存储，能省不少事情。

这篇慎模文章就介绍怎么使用kotlin 和Spring Boot上传文件

完整 build.gradle 文件

创建文件上传controller

上传文件服务的接口

上传文件服务

自定义异常

配置文件上传目录

启动Spring Boot

创建一个简单的 html模板 src/main/resources/templates/uploadForm.html

配置文件 application.yml

更多Spring Boot 和 kotlin相关内容，欢迎关注 《Spring Boot 与 kotlin 实战》

https://github.com/quanke/spring-boot-with-kotlin-in-action/

前言，因为需要写一个播放器测试，需要读取到手机文件路径稿亏掘以获取到 mp4 格式文件的路径，进而播放，发现网络上的大多有问题，这里写下以作笔记记录。

1.存储方式分为三部分：

先理解， 路径、绝对路径/相对路径、规范路径空如

总结： 路径 包含 绝对键核路径/相对路径 ， 绝对路径 包含 规范路径 ，而 相对路径 不包含 规范路径 。

真实返回：

(待写)

参考 https://www.jianshu.com/p/343b1daf16a0

externalCacheDir

getExternalCacheDirs （废弃？）

externalFilesDir

externalFilesDirs ：kotlin是需要文件夹？

getExternalStoragePublicDirectory 废弃

虽然被弃用，但是仍旧可以使用，并且好用，但是必须获取 READ_EXTERNAL_STORAGE ，在 AndroidManifest.xml 加入

getExternalStorageDirectory 废弃

getExternalStorageState

StorageManager

content.filesDir

cacheDir

nobackupFiles

codeCacheDir

datadir

packageCodePath

packageResourcePath (废弃？)

dataDirectory kotlin里是 datadir

downloadCacheDirectory (废弃？)

rootDirectory (废弃？)

还是 getExternalStoragePublicDirectory 虽然已经废弃，但是还是很好用。暂时无法找新的方法代替，有新的再更新。

---