来自
Linux桌面世界,我将习惯将我的应用程序的用户文档写成一组markdown / docbook /任何文件,在构建时生成相应的HTML文件,并将其与我的应用一起分发,以便被查看有一些帮助查看器,如
yelp,kchmviewer,Okular或类似(我们在说基于GUI的应用程序,如Gnome和KDE,所以manpages和信息页面不涉及这里).
Android不提供任何类似的东西.没有官方支持,建议/强制性的方式来创建,管理和分发最终用户的文档(至少AFAIK).没有用于此任务的工具(放弃Web浏览器和/或Webview).
目前,我们正在保留一组HTML文件(完全独立于源代码树),我们只是为用户提供一个在网络上阅读的链接(从他自己的设备中,如果屏幕尺寸允许这样的阅读,或从不同的设备).
替代方案似乎是：
把你所有的东西放在/资产或/ res目录中
>将用户的index.html页面显示到默认的Web浏览器中(或者在对话框内的WebView内部),并让他浏览其余的文档.
有没有人知道为Android应用程序创建,管理和分发用户文档的更好(更有组织,更好的设计)方式？
是的：我知道移动应用程序通常预期几乎完全是自动记录的(也就是说,用户界面可以以正确的方式领先用户,无需任何其他帮助).不幸的是,我们正在开发一些需要一定数量的以前的knwoledge才能使用的东西.
解决方法
像“展示视图”这样的东西可能有助于解释简单的UI元素.在GitHub：
https://github.com/Espiandev/ShowcaseView上有一个很好的实现
