Rocket
Getting Involved
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.
Build instructions
- Clone the repository:
git clone https://github.com/mozilla-tw/Rocket
-
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
-
Disable Instant Run in: Settings/Build, Execution, Deployment > Instant Run. (See note #1 for details.)
[1] We currently don't support instant run. An error message similar to:
/Users/tyu/Documents/zerda/Rocket/app/src/main/java/org/mozilla/focus/utils/FirebaseHelper.java:29: error: cannot find symbol
final public class FirebaseHelper extends FirebaseWrapper {
^
symbol: class FirebaseWrapper
will shown when building with instant run. We have an issue for this so feel free to help with this limitation. To disable instant run , press Cmd+Shit+a on Mac or Ctrl+Shift+a on Windows and enter "instant run" under "Preference" category. If it still doesn't work, try enter ./gradlew clean"
on mac or gradlew clean
on Windows using command line in the project root.
Build instructions regarding Firebase
We're leveraging Firebase to offer some extra functionalities. However, Firebase is optional so normally you should be able to just develop on focusWebkitDebug.
Here are some Firebase build workarounds that you may need during normal development:
- If you want to run UI test without setting up firebase tokens, remove
testBuildType "firebase"
from build.gradle or you will most likely see error message like this when you run connectedAndroidTest directly:
No tests found. This usually means that your test classes are not in the form that your test runner expects (e.g. don't inherit from TestCase or lack @Test annotations).
If you'd like to test the fully functional Firebase build, you should first setup the environment variables following these instructions and select focusWebkitFirebase
Docs
License
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/