Bitocle是什么？
Bitocle是一款简单的用来查看自己托管在GitHub上的代码的安卓应用。
版本号：2.2 Release
下载链接：https://play.google.com/store/apps/details?id=io.github.mthli.Bitocle
支持安卓4.0及其以上版本设备。
特别说明：
-
Bitocle使用OAuth登陆GitHub，不会记录您登陆时输入的GitHub密码。
-
在Bitocle中完成的操作不会影响您托管在GitHub上面的内容，可以理解为，它是只读的。
如何使用它呢？
首先来看应用截图：
我们规定打开应用看到的第一个列表为“主列表”。
-
搜索框会自动补全当前输入内容，筛选出主列表中符合输入的项目，点击列表项即可快速跳转至项目。
-
在搜索框中按照“用户名/项目名”的格式输入字符，并点击输入法上的“发送（回车）”键，即可将输入的项目添加到主列表。
-
在“近期加星”列表中，点击列表项右侧的菜单按钮，可以选择将加星项目添加到主列表。
-
在项目的目录树下长按列表项可以选择添加书签。
-
在书签界面长按列表项可以选择删除书签。
-
点击Overflow菜单中的“代码高亮”，可以选择5种不同的高亮模式，方便阅读代码。
-
点击Overflow菜单中的“代码横屏”，可以在阅读代码的时候自动横屏。
-
点击Overflow菜单中的“夜间模式”，可以降低屏幕亮度，方便夜间阅读。
-
Overflow菜单中的“刷新选项可以在数据加载失败的时候重载数据，但是不建议频繁的刷新。
-
左上角的返回键无论何时都会返回主列表。
-
屏幕下方的返回键用于返回当前位置的上一层；在点击书签项之后原有的目录树将会被新的目录树覆盖。
目前存在哪些问题？
-
不能优雅的退出应用。涉及网络操作的线程在快速退出时可能导致下次启动时白屏，因此使用了
System.exit(0)直接将应用kill掉，所有就没有退出动画了。 -
代码逻辑不够完美，导致应用的流畅性可能受到影响。
-
缺少缓存。目前我并没有找到比较好的可以实现缓存的方式，由此导致每次查看代码的时候都需要进行网络操作，效率不高。如果你有什么比较好的想法，可以联系我，联系方式见下文。
-
应用程序的启动图标。有意向的同学可以考虑帮我绘制一个漂亮的图标，联系方式见下文。
-
在代码高亮时WebView加载及渲染效率较低的问题。
-
当一行代码太长，在暗色系主题下WebView会显示白边。这属于代码风格问题，通常不推荐写太长不折行的代码。有兴趣的同学可以参阅google-styleguide。
-
Webview加载Markdown文件有时候无法显示图片，这取决于图片的大小和网络问题。
-
中文乱码。使用UTF-8编码格式能有效防止中文乱码的出现。
-
部分机型的适配问题，以及其他未知Bug（边界问题）。
下一阶段打算做什么？
-
尝试解决以上提到的Bug。
-
优化代码。
-
美化UI。
关于项目：
-
项目主页：Bitocle
-
开发者：Matthew Lee
Thanks:
Bitocle在开发过程中使用了以下开源项目：
同时也要感谢支持这个项目的所有人，我会继续努力哒！
What is Bitocle?
Bitocle is a simple app that allows you to view your code on GitHub.
Version: 2.2 Release
For Android 4.0+.
Download link: https://play.google.com/store/apps/details?id=io.github.mthli.Bitocle
Some explains:
-
Bitocle use OAuth so you don't worry about your GitHub Password, we don't use/save it.
-
Bitocle is Read Only, we don't change any thing on your GitHub.
-
Sorry for my poor English :)
How to use it?
Screenshot:
We call the first list you see main list.
-
You can use
Searchto quick skip on main list. -
Type
User/Repostyle onSearch, you can add the repo(User/Repo) to main list. -
On
Starinterface, you can click the right button on a(n) item andAddmeans you can add this item to main list. -
On catalog, long click, add bookmark.
-
On
Bookmarkinterface, long click, remove bookmark. -
Use the menu item
HighlightofOverflowon ActionBar to select awesome source highlight effect. -
Use the menu item
HorizontalofOverflowon ActionBar, Bitocle will auto landscape when you view your code. -
Use the menu item
NightofOverflowon ActionBar for night. -
The
Backbutton on the left of ActionBar will back to main list whenever/wherever. -
The
Backbutton on the button of screen will back to the previous interface you ever seen; but when you clickBookmarkmenu, it will be reset.
Does Bitocle has some matters?
-
We use
System.exit(0)to quit, for killing some unknown threads. So it is not very grace. -
No cache. I have no idea to make it come true.
-
The icon of Bitocle looks no very good, I hope someone could help us make a(n) awesome icon.
-
jQuery on WebView looks not very efficent.
-
When a line is too long, WebView will show whiht edge when you use some dark themes. We don't suggest you to write too long, see google-styleguide.
-
When WebView load Markdown, the image may loaded failed, for network state or other reasons.
-
We suggest you use UTF-8 encoding for no messy code.
-
Failed to adapt some phone.
What we will do next?
-
Try to fix some bugs.
-
Optimize Bitcole source code.
-
Optimize UI.
About Project:
-
Homepage: Bitocle
-
License: Apache License, Version 2.0
-
Author: Matthew Lee
Thanks:
When we develop Bitcole, those open source projects we use:
And thanks all supporter :)