Need help with Bitocle?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

mthli
203 Stars 41 Forks Apache License 2.0 162 Commits 2 Opened issues

Description

Bitocle is a simple android app which allows you to view your source code in GitHub.

Services available

!
?

Need anything else?

Contributors list

No Data

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上面的内容,可以理解为,它是只读的。

如何使用它呢?

首先来看应用截图:

all_in_one.png

我们规定打开应用看到的第一个列表为“主列表”。

  • 搜索框会自动补全当前输入内容,筛选出主列表中符合输入的项目,点击列表项即可快速跳转至项目。

  • 在搜索框中按照“用户名/项目名”的格式输入字符,并点击输入法上的“发送(回车)”键,即可将输入的项目添加到主列表。

  • 在“近期加星”列表中,点击列表项右侧的菜单按钮,可以选择将加星项目添加到主列表。

  • 在项目的目录树下长按列表项可以选择添加书签。

  • 在书签界面长按列表项可以选择删除书签。

  • 点击Overflow菜单中的“代码高亮”,可以选择5种不同的高亮模式,方便阅读代码。

  • 点击Overflow菜单中的“代码横屏”,可以在阅读代码的时候自动横屏。

  • 点击Overflow菜单中的“夜间模式”,可以降低屏幕亮度,方便夜间阅读。

  • Overflow菜单中的“刷新选项可以在数据加载失败的时候重载数据,但是不建议频繁的刷新。

  • 左上角的返回键无论何时都会返回主列表。

  • 屏幕下方的返回键用于返回当前位置的上一层;在点击书签项之后原有的目录树将会被新的目录树覆盖。

目前存在哪些问题?

  • 不能优雅的退出应用。涉及网络操作的线程在快速退出时可能导致下次启动时白屏,因此使用了

    System.exit(0)
    直接将应用kill掉,所有就没有退出动画了。
  • 代码逻辑不够完美,导致应用的流畅性可能受到影响。

  • 缺少缓存。目前我并没有找到比较好的可以实现缓存的方式,由此导致每次查看代码的时候都需要进行网络操作,效率不高。如果你有什么比较好的想法,可以联系我,联系方式见下文。

  • 应用程序的启动图标。有意向的同学可以考虑帮我绘制一个漂亮的图标,联系方式见下文。

  • 在代码高亮时WebView加载及渲染效率较低的问题。

  • 当一行代码太长,在暗色系主题下WebView会显示白边。这属于代码风格问题,通常不推荐写太长不折行的代码。有兴趣的同学可以参阅google-styleguide

  • Webview加载Markdown文件有时候无法显示图片,这取决于图片的大小和网络问题。

  • 中文乱码。使用UTF-8编码格式能有效防止中文乱码的出现。

  • 部分机型的适配问题,以及其他未知Bug(边界问题)。

下一阶段打算做什么?

  • 尝试解决以上提到的Bug。

  • 优化代码。

  • 美化UI。

关于项目:

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:

all_in_one.png

We call the first list you see

main list
.
  • You can use

    Search
    to quick skip on main list.
  • Type

    User/Repo
    style on
    Search
    , you can add the repo(
    User/Repo
    ) to main list.
  • On

    Star
    interface, you can click the right button on a(n) item and
    Add
    means you can add this item to main list.
  • On catalog, long click, add bookmark.

  • On

    Bookmark
    interface, long click, remove bookmark.
  • Use the menu item

    Highlight
    of
    Overflow
    on ActionBar to select awesome source highlight effect.
  • Use the menu item

    Horizontal
    of
    Overflow
    on ActionBar, Bitocle will auto landscape when you view your code.
  • Use the menu item

    Night
    of
    Overflow
    on ActionBar for night.
  • The

    Back
    button on the left of ActionBar will back to main list whenever/wherever.
  • The

    Back
    button on the button of screen will back to the previous interface you ever seen; but when you click
    Bookmark
    menu, 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:

Thanks:

When we develop Bitcole, those open source projects we use:

And thanks all supporter :)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.