gejiaheng / protein Goto Github PK

:egg: An Android App for Dribbble

License: Apache License 2.0

Java 100.00%

dribbble mvp-architecture mvp-android autovalue rxjava2 dribbble-client android-app

protein's Introduction

Protein

Protein is an atypical Dribbble App designed with one cup of simplicity and two spoons of fun. It is fully open sourced but also published on Google Play. You can discuss how-tos and best practices on creating an Android App around Protein.

Attention

Due to the breaking change of Dribbble API v1, I need to migrate to API v2. Unfortunately, most of the current features are't supported by API v2. So, in the following months, I'll:

Try to recover some basic features
Implement a redesign of Protein

Highlights

Material Design: Not a typical Material Design App, but you will find some familiar elements in Protein.
MVP architecture: Whole project is built on MVP. Views are implemented by custom views and fragments with activity being pure container.
RxJava: Model layer supported by RxJava. Also compose activity and fragment's lifecycles.
Auto Value: Auto valued all the models to gain some benefits.
Configuration change: Handles configuration changes like a charm.
Firebase: Firebase Analytics integrated. Only configured for product flavor play.
Stetho: Better debug.
Deep link: Showcase deep link mechanism with ShotActivity, empowers your native App.
Test: Yes, a few UI tests. More coming, still working on this.

Screenshots

Main	Shot	User	Comment

Build

Get Started

./gradlew installOpenDebug

Attentions

As we are using bleeding edge versions of gradle wrapper, gradle plugin and Android Studio. You may come across some build problems, don't panic, try the followings:

Update Android Studio to latest beta/canary version. Current is Android Studio 3.0 Beta 5
If you're having gradle plugin too old error, do as /build.gradle tells you.
Use gradlew instead of your local gradle.
Try to clean project and restart Android Studio.
If none of the above solve your problem, file an issue.

Product Flavors

open: For open source purpose, use this flavor to develop and debug.
play: For Google Play publish, maintained by Jiaheng Ge ([email protected]).

Dribbble OAuth

Dribbble API client id, client secret and client access token for flavor open are placed in dribbble_config_open.properties. The property file for flavor play is not committed to git.

You may come across API rate limiting according to Rate Limiting. I suggest you register a dribbble application here if you want to develop continually. As for Callback URL, you can use x-protein-oauth-dribbble://callback as default. Or you can define your own url, and modify relative constants in ApiConstants.java.

Distribute

Protein is published on Google Play. The distribution is maintained by Jiaheng Ge ([email protected]). The GitHub Contributors page will have an entry in the App.

Contribute

Protein is an Open Source Project

Please check out Protein's Roadmap and Todos

License

Copyright 2017 Jiaheng Ge ([email protected])

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.

protein's People

Contributors

Stargazers

Watchers

protein's Issues

dribbble_config_play.properties (系统找不到指定的文件。)

On Library List CustomTab cannot open

Under Licenses on Library list click item cause this error.
java.lang.NoClassDefFoundError: Failed resolution of: Landroid/support/customtabs/CustomTabsIntent$Builder;
I noticed that the other library is yours too :) Congrats .Good job but CusTomTabs throw exception.

TransactionTooLargeException

TransactionTooLargeException throwed when click on an item of the list and switch to another Activity.
I have limit the amount data to one page in onSaveInstanceState() as it would be called every time you fire an intent and switch to another Activity. But this exception still happens.

Cannot build. Internal compiler error

It gets this error:
Error:16:49:27.066: SEVERE: com.android.jack.CommandLine: Internal compiler error (version 1.3-b19 'Douarn' (425700 24821ef75db0755f4803d46bd8bf9f37907c64ac by [email protected])):

请教个问题，autoValue配gson怎么用泛型？

@AutoValue
public abstract class Result<T> {

    public abstract int status();
    public abstract String message();
    public abstract T data();

    public static <T> TypeAdapter<Result<T>> typeAdapter(Gson gson, TypeToken<T> typeToken) {
        return new AutoValue_Result.GsonTypeAdapter(gson, typeToken).nullSafe();
    }

}

请求返回固定格式，这样一个泛型，请求成功是没有问题，但是失败了，返回
{"status":0,"message":"","data":""}或{"status":0,"message":""}解析都出错，这种怎么解决呢？（不使用autovalue是没有问题的）