Skip to content

Latest commit

 

History

History
86 lines (47 loc) · 6.09 KB

README.md

File metadata and controls

86 lines (47 loc) · 6.09 KB
Raw

Code Reader+ v1.1

Home repo for our Windows Store app: https://www.microsoft.com/store/apps/9ntphrk6qlfg

There is no better place to communicate between developers than GitHub. This is the place for Code Reader+. Report bugs, file issues, suggest features or contribute some code for the next release. :)

The planning and announcements would also be done here.

Limitations

Protocols

  1. Only git is supported via our own robin-git C# library; i.e. no current support for SVN, Mecurial, TFS or plain folder.
  2. On git we only support git servers that use Smart Http protocol; i.e. no Dumb Http protocol supported.
  3. On git only HTTP/HTTPS are supported, SSH can be added if there is demand.
  4. On GitHub we only support public repositories; Private repo access is planned for v1.2.

C# (Language Service)

  1. Analysis ability is up to C#6. Support of C#7 is planned with low priority.
  2. Only basic Type information is collected. Type members includes methods, properties, fields, etc., and local variable declaration can be collected with more work not yet scheduled.
  3. We don't yet understand the concepts of project and solution, thus analysis was on a commit (in git terms, it is tree-ish, i.e. a file directory). Therefore our type table needs to tolerant duplication, i.e. a type could be defined in multiple files.
  4. Until we further optimise our ability to collect/access type info faster and reduce the storage footprint, it's not wise to analysis gigantic repositories, e.g. Corefx, without limiting the files to process.

Git Repo Size

  1. Due to the limitation in current robin-git lib, we can only handle git repo size <= 2GB.
  2. git resolve is very resource intensive, we have attempted to clone Linux kernel repo on our 4GB tablet, and never able to complete the resolve to 100%, seems the OS terminated us without giving HockeyApp a chance to report exception. We will add --depth support to robin-git in v1.2 release.

UWP

  1. We would wanted to make git clone truly run in the background, but two things are stopping us: one is that until the Anniversary Edition of Windows 10, we can't really run a background task indefinitely. Cloning a large repo could take a long time depending on the network bandwidth; second, git smart http protocol is stateless, it does not support partial downloading or resume a previous session. Thus the clone op always happen in the foreground, we suggest you to let the app stay in the foreground until the clone is done, and don't let the tablet sleep, especially for large repo. The receiving part can survive short pauses e.g. 2 or 3 minutes, seems the UWP sandbox is doing a great work to maintain the http connection with git server by keep-alive traffic; the resolving part can be paused much longer but it's CPU intensive, when the app was sent background, Windows 10 freeze it, when active again, the resolving would carry on.

Devices Dev/Tested On

  1. Lenovo ThinkPad X1 Carbon 3rd gen (touchscreen), 8GB memory, Windows 10 pro 64 bit
  2. AlldoCube iWork7 7" Intel Z3735G BayTrail 2GB memory, Windows 10 home 32bit
  3. AlldoCube iWork12 12" Intel Z8300 CherryTrail 4GB memory, Windows 10 home 64 bit

Design Principles

  • Code Reader+ is a reader, there is no plan to turn this into a writer or IDE in any sense.
  • given above read only principle, we are unlikely to offer git commit or push in foreseeable future.
  • there are plenty of hard problems to solve in the read side, if we could solve some of those we'll be helping the world on programming productivity and quality a lot.
  • Touchscreen is great for consuming information (this is manifested by the popularity of ipad), reading code can be passive or active or both.
  • Touch is our main interactive means in our app; although you can still use a keyboard and mouse, but that's a fallback.
  • Offline is pillar for our app, so we try to do everything within our app without you needing to jump to another app.
  • we truly buy the Immersive modern UI design language, thus our UI is minimalist, giving you maximum screen real estate for viewing the code.

Next Release v1.2

  • Retro back to Git Story: add Git Fetch/Pull, Clone with Depth, Checkout commit/single file, Access of GitHub private repositories with credentials.

Known Issues

v1.1

  1. On Repo List page, items are sorted by Likes, but not considering the exact time Likes are flagged. So the order might be different from your last session. This is by design unless we have a requirement to also take the flagging time into sort order.

  2. On Repo Blade page, the total count for Commits only reflect what is already loaded, since it was backed by an IIncrementalSource. This is by design and we could do better to also show the real total once the robin-git library supports that.

  3. On Repo Blade page, if you enable Global filter for "Likes" then disable it, the Commits blade will show the total commits count correctly, since we are trying to search for the selected item here without limiting how far we go, thus we enumerated everything with the side effect that we got the total commits. This can be improved.

  4. On Repo Blade page, after you open up some levels, and toggle Global Likes Only button, for a blade that the opened item is not Liked, when you toggle Likes Only off, the blade does not scroll to show the opened item, this can be improved. Workaround: go to Code page and back.

  5. On Repo Blade page, if you swipe open a folder on one level, while the next level is shown, if you swipe open a file on the same level as the folder, the file would be open in Code Page, if you go back Blade page, the opened folder would not close due to your selection of a file. This is for the convenience and can be improved for right use case.

Proudly using

Get it on Windows 10