Giter VIP home page Giter VIP logo

comicvine-android's Introduction

Android Boilerplate

License Apache 2.0 ustwo twitter Platform Android

Description

Android boilerplate project to create new Android projects from. It provides basic architecture, tools and guidelines that we use when developing Android apps.

Getting started

First clone the boilerplate repository. Next, if you want to copy the boilerplate into your own repository follow Clone into your own repository. If you just want to get started with customising things for your own project skip onto Make it your own.

Clone into your own repository

Follow these steps if you have a repository with a branch you'd like to copy the boilerplate project into:

$ cd <path to boilerplate>
$ git remote add newrepo <path to newrepo>
$ git checkout --orphan copy
$ git commit -m "Copying boilerplate"
$ git push newrepo copy:<branch on new repo>

This will copy the boilerplate project without history to your own branch in your repository.

Make it your own

Personalise the boilerplate for your own project:

  1. Rename com.ustwo.boilerplate packages to your own domain's stucture. E.g com.mydomain.myapp. See StackOverflow for steps to easily accomplish this in Android Studio.

  2. Open app/build.gradle and change the following to match your new package names:

    • applicationId "com.mydomain.myapp"
    • testInstrumentationRunner "com.mydomain.myapp.application.ApplicationTestRunner"

Modules

This project consists of the following modules:

  • app, Phone & tablet module

Tools

  • Android Studio, Provides the fastest tools for building apps on every type of Android device.
  • Gradle, An open source build automation system.

Testing and CI

Circle

By default this boilerplate comes configured to run on CircleCI. The YML file circle.yml will setup the dependencies, run the tests configured in scripts/ci.sh and export relevant reports and artefacts.

If you have configured the environment variables defined in the "Firebase cloud testing" the tests will be run on the Firebase test lab otherwise your tests will be run on an emulator.

Firebase cloud testing

This boilerplate ships with Firebase cloud testing built in. You simply need to enter the following environment variables to make it work:

  • GCLOUD_SERVICE_ACCOUNT - The service account email address is listed in the Firebase console here: https://console.firebase.google.com/project/<projectId>/settings/serviceaccounts/adminsdk
  • GCLOUD_SERVICE_KEY - This is an export of the contents of the JSON secret file that can be obtained by generating a new private key here: https://console.firebase.google.com/project/<projectId>/settings/serviceaccounts/adminsdk
  • GCLOUD_PROJECT_ID - This is a unique identifier for your Firebase project which can be found in this project's URL: https://console.firebase.google.com/project/<projectId>

The cloud testing setup by default will run your instrumentation tests, take screenshots and save the test report and artefacts.

Signing and secrets

The repository contains two files responsible for secrets and signing; ci-keys.cipher and release.keystore.cipher respectivly. Both files have been encrypted using openssl aes-256-cbc with the key ustwoopensource. These files are intended solely as placeholders to allow you to make release builds and need to be replaced before releasing to the app store.

The current secret management implementation is simple when you have a small number of secrets or files that need encrypting and / or a small team. If you are working on a large project where access to secrets and files should be more carefully managed then we recommend using BlackBox by StackExchange.

Editing secrets

To add, view or edit secrets you first need to decrypt them using openssl:

openssl aes-256-cbc -d -out ci-keys -in ci-keys.cipher -k ustwoopensource

This will creat a file called ci-keys which you can then edit as needed and encrypt again using:

openssl aes-256-cbc -e -in ci-keys -out ci-keys.cipher -k ustwoopensource

The file ci-keys.cipher will then be ready to commit.

The same process can be used with release.keystore.cipher when you need to replace or change the keystore with your own details.

CI setup

For the secrets and keystore to be used by your CI server you will need to export the environment variable CI_SECRETS_KEY with the default key listed above or your own if you've re-encrypted the secrets and keystore yourself. You will also need to ensure that openssl is added as a dependency / installed by default.

Code Standards

Code of Conduct

Contributing

Please, take some time before starting a contribution to read our documentation

Updating gitignore

The gitignore file is generated using GitIgnore.io and using Android and Intellij for the selected technologies. This allows for easy updating when tools are updated or otherwise when required.

Note that gitignore is not setup to ignore common OS files like Thumbs.db or .DS_Store. For this we recommend creating a global gitignore file that will apply to all of your projects. This guide explains how. GitIgnore.io provides content for a variety of OS to copy and paste in.

Contact

[email protected]

comicvine-android's People

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.