We encourage you to participate in this open source project. We love Pull Requests, Bug Reports, ideas, (security) code reviews or any kind of positive contribution. Please read the Community Participation Guidelines.
- Clone the repository:
git clone https://github.com/RocketScientists/Rocket
- Since we're using submodule, run:
git submodule init
git submodule update
- Open Android Studio and select File->Open and select Rocket to open the project. Make sure to select the right build variant in Android Studio: focusWebkitDebug
We're leveraging Firebase to offer some extra functionalities. However, Firebase is optional so normally you should be able to just develop on focusWebkitDebug.
To minimize the chance you are blocked by our build checks, you can self check these locally:
- (build) run
./gradlew clean checkstyle assembleFocusWebkitDebug lint assembleAndroidTest ktlint
- (size check) run
python tools/metrics/apk_size.py focus webkit
- (Unit test) run
./gradlew testFocusWebkitDebugUnitTest
- (UI test) run
./gradlew connectedAndroidTest
- Run
./gradlew ktlintApplyToIDEA
to make your IDE align with ktlint - Run
./gradlew ktlint
to run check - If you want to go extreme, run
./gradlew ktlintExec -Parg="-a -F"
. This will use Android rule and gives you a lot of complains about max length, but we are not using it right now. - See https://ktlint.github.io/ for details.
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/