-
Notifications
You must be signed in to change notification settings - Fork 2.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Seperated and Added to the Linux and Andriod Install Pages #38942
Open
alanakihn
wants to merge
1
commit into
brave:master
Choose a base branch
from
alanakihn:master
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+120
−0
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
|
||
# Android Development Environment | ||
|
||
## Making Debug Build for Android | ||
|
||
To ensure the output format is APK, add `--target_android_output_format=apk` to the build command: | ||
|
||
```bash | ||
npm run build -- Debug --target_os=android --target_arch=arm --target_android_output_format=apk | ||
``` | ||
|
||
To change the target SDK level, add `--target_android_base`: | ||
|
||
```bash | ||
npm run build -- Debug --target_os=android --target_arch=arm --target_android_output_format=apk --target_android_base=mono | ||
``` | ||
|
||
## Installing a Build on Android | ||
|
||
For devices or an emulator: | ||
|
||
```bash | ||
./src/build/android/adb_install_apk.py ./src/out/android_Debug_x86/apks/Bravex86.apk | ||
``` | ||
|
||
Or: | ||
|
||
```bash | ||
adb install ./src/out/android_Debug_x86/apks/Bravex86.apk | ||
``` | ||
|
||
If you have an AAB file: | ||
|
||
```bash | ||
bundletool build-apks --connected-device --bundle=out/android_Debug_x86/apks/Bravex86.aab --output=out/android_Debug_x86/apks/Bravex86.apks | ||
bundletool install-apks --apks=out/android_Debug_x86/apks/Bravex86.apks | ||
``` | ||
|
||
## Getting Crash Dumps for Android | ||
|
||
```bash | ||
adb logcat -d | third_party/android_platform/development/scripts/stack --output-directory out/android_Component_arm | ||
``` | ||
|
||
## Other Debugging Instructions for Android | ||
|
||
Refer to the [Chromium debugging instructions](https://chromium.googlesource.com/chromium/src/+/main/docs/android_debugging_instructions.md). | ||
|
||
## Setting Up an Android Emulator | ||
|
||
To set up an Android emulator, follow these steps: | ||
|
||
1. Install Android Studio from the [official website](https://developer.android.com/studio). | ||
2. Open Android Studio and navigate to the AVD Manager. | ||
3. Create a new virtual device and select the desired phone model and system image. | ||
4. Configure the emulator settings and finish the setup. | ||
5. Start the emulator from the AVD Manager. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -0,0 +1,63 @@ | ||||||
|
||||||
# Linux Development Environment | ||||||
|
||||||
## System Requirements | ||||||
|
||||||
Ensure your system satisfies the [system requirements](https://chromium.googlesource.com/chromium/src/+/main/docs/linux_build_instructions.md#System-requirements). | ||||||
|
||||||
## Install Additional Build Dependencies | ||||||
|
||||||
You will need Git, Python 3 and Node.js active LTS (v20+). You may need to make python3 the default if Python 2.7 is default for your OS. Also, if you don't have anything named python on your machine and only have `python3`, you will need something like `python-is-python3` | ||||||
|
||||||
Alternatively, you can use Yarn. Follow the [Yarn install docs](https://yarnpkg.com/getting-started/install) to install Yarn and a compatible version of Node.js. After installing Yarn, run `yarn import` to create a `yarn.lock` file from `package-lock.json`. | ||||||
|
||||||
## Additonal installs for different Linux distributions: | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
||||||
### For Ubuntu Users | ||||||
|
||||||
```bash | ||||||
apt-get install build-essential python-setuptools python3-distutils | ||||||
``` | ||||||
|
||||||
### For Fedora Users | ||||||
|
||||||
```bash | ||||||
dnf install @development-tools python3-devel | ||||||
``` | ||||||
|
||||||
### For Arch Linux Users | ||||||
|
||||||
```bash | ||||||
pacman -S base-devel python | ||||||
``` | ||||||
|
||||||
### For Red Hat Users | ||||||
```bash | ||||||
yum groupinstall 'Development Tools' && yum install python3-devel | ||||||
``` | ||||||
|
||||||
### For openSUSE Users | ||||||
|
||||||
```bash | ||||||
zypper install -t pattern devel_basis | ||||||
zypper install python3-devel | ||||||
``` | ||||||
|
||||||
### General Instructions | ||||||
|
||||||
After cloning and initializing the repo, run the following script to finish installing build dependencies: | ||||||
|
||||||
```bash | ||||||
# cd to brave-browser repo root | ||||||
./src/build/install-build-deps.sh # for Linux | ||||||
``` | ||||||
|
||||||
For unsupported distributions: | ||||||
|
||||||
```bash | ||||||
./src/build/install-build-deps.sh --unsupported | ||||||
``` | ||||||
|
||||||
## Troubleshooting | ||||||
|
||||||
Check out the upstream [Checking out and building Chromium on Linux](https://chromium.googlesource.com/chromium/src/+/main/docs/linux_build_instructions.md#Checking-out-and-building-Chromium-on-Linux) docs before filing an issue. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
.