基于MVP架构和Material Design设计风格,采用RxJava2, Retrofit2, Realm and ZXing开发的快递查询App

Espresso Android App

icon

Espresso is an express delivery tracking app designed with Material Design style, built on MVP(Model-View-Presenter) architecture with RxJava2, Retrofit2, Realm database and ZXing.

The source code in this repository reflects the app which supports mobile devices running Android 5.0+.

Features

With this app, you can:

  • Support over 600 express companies.
  • Add packages by inputting the package number or just scanning the express sheet.
  • Recognize the company of a package automatically.
  • View the package's details such as the latest location.
  • Search information about the express companies.
  • Launcher widgets.
  • Get important notification when the package is on delivery.
  • Send feedback on using experience from your devices.

Screenshots

screenshot0

screenshot1

How to Work with the Source

I hope the source code for this app is useful for you as a reference or starting point for creating your own app. Here is some instructions to help you better build and run the code in Android Studio.

Clone the Repository:

git clone https://github.com/TonnyL/Espresso.git

Check out the master branch:

git checkout master

Notice: If you want to review a different branch, replace the master with the name you want to checkout if it does exist. Finally open the Espresso/ directory in Android Studio.

Suggestion: It is better for you to update your Android Studio to version 2.3 when you open this project.

To-dos

This project is still in progress. Here are the some features that I will finish in the future.

  • [x] Refreshing package details by accessing the network.
  • [x] Launcher app widgets.
  • [x] App Shortcuts on devices that running Android 7.1+.
  • [x] Material design app onboarding pages.
  • [x] Chrome Custom Tabs.
  • [x] Alphabet indexing for companies list.
  • [x] Search packages and companies.
  • [ ] Day and night mode.
  • [x] Service to build notifications.
  • [x] Settings and about page.
  • [ ] Supporting Android Wear.
  • [ ] UI test and unit test.

Help Me Improve This App

  • As you can see at the screenshots, some images in Espresso app are not suitable. So if you are a designer and familiar with Material Design and want to help me make the app look better, please email me.
  • If you want to improve the translation of Espresso, do not hesitate to email me. Let us make Espresso more and more popular all over the world.

Libraries Used in This App

NameIntroductionVersion
Android Support LibrariesThe Android Support Library offers a number of features that are not built into the framework. These libraries offer backward-compatible versions of new features, provide useful UI elements that are not included in the framework, and provide a range of utilities that apps can draw on.25.2.0
CircleImageViewA circular ImageView for Android2.1.0
GsonA Java serialization/deserialization library that can convert Java Objects into JSON and back.2.7
MaterialDateTimePickerPick a date or time on Android in style.3.1.3
RealmRealm is a mobile database: a replacement for SQLite & ORMs.3.0.0
RetrofitType-safe HTTP client for Android and Java by Square, Inc.2.2.0
RxAndroidRxJava bindings for Android.2.0.1
RxJavaRxJava – Reactive Extensions for the JVM – a library for composing asynchronous and event-based programs using observable sequences for the Java VM.2.0.1
ZXingZXing ("zebra crossing") is an open-source, multi-format 1D/2D barcode image processing library implemented in Java, with ports to other languages.3.3.0

Thanks to

License

Copyright 2017 lizhaotailang
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.