Skip to content

Latest commit

 

History

History
75 lines (60 loc) · 2.94 KB

CONTRIBUTING.md

File metadata and controls

75 lines (60 loc) · 2.94 KB

Contributing

Would you like to contribute code?

  1. Fork SeriesGuide.
  2. git checkout -b descriptive-branch-name dev and make great commits + messages.
  3. Start a pull request against dev. Reference existing issues when possible.

No code!

Branch structure

The repository is made up of two main branches: master (stable) and dev (unstable).

  • master has the latest stable code, its tags are released as SeriesGuide on Google Play.
  • dev includes the latest unstable code from contributers (you!).

Setup

This project is built with Gradle, the Android Gradle plugin and uses jars or Maven dependencies. Clone this repository inside your working folder. Import the build.gradle file in the root folder into e.g. Android Studio. (You can also have a look at the build.gradle files on how the projects depend on another.)

Before your first build create the following files:

  • gradle.properties, add the following values (do not need to be valid Sonatype credentials):
ossrhUsername=sonatypeUsername
ossrhPassword=sonatypePassword
  • SeriesGuide/src/main/res/values/keys.xml, add the following values:
<resources>
    <string name="getglue_client_id"></string>
    <string name="getglue_client_secret"></string>
    <string name="tvdb_apikey"></string>
    <string name="tmdb_apikey"></string>
    <string name="trakt_apikey"></string>
    <string name="key_a"></string>
    <string name="key_b"></string>
    <string name="key_c"></string>
    <string name="key_d"></string>
</resources>
  • SeriesGuide/src/free/AndroidManifest.xml, add the following content:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.battlelancer.seriesguide">

    <application>
        <!-- Crashlytics -->
        <meta-data android:name="com.crashlytics.ApiKey" android:value="0000000000000000000000000000000000000000"/>
    </application>
</manifest>

Now build any variant of the free flavor (flavor + debug build type, see instructions about product flavors) defined in SeriesGuide/build.gradle.