manifest_pb/README.md

110 lines
2.8 KiB
Markdown
Raw Normal View History

2018-11-21 06:10:54 -08:00
<div align="center">
<img src ="PitchBlack-Banner.png">
</div>
<h1 align="center">
PitchBlack Recovery Project
</h1>
<h2 align="center">
An Open Source custom recovery for android
</h2>
<div align="center">
<a href="#">
<img src="https://img.shields.io/badge/platform-android-blue.svg?style=flat-square"
alt="platform" />
</a>
<a href="#">
<img src="https://img.shields.io/badge/build-stable-brightgreen.svg?style=flat-square"
alt="build" />
</a>
<a href="#">
<img src="https://img.shields.io/badge/version-2.9.0-green.svg?style=flat-square"
alt="version">
</a>
2018-11-21 06:13:28 -08:00
<a href="#">
2018-11-21 06:10:54 -08:00
<img src="https://img.shields.io/badge/base-twrp 3.2.3-orange.svg?style=flat-square"
alt="base">
</a>
</a>
2018-11-21 06:13:28 -08:00
<a href="https://github.com/PitchBlackRecoveryProject/android_bootable_recovery/blob/PBRP/LICENSE">
2018-11-21 06:10:54 -08:00
<img src="https://img.shields.io/badge/license-apache%202.0-3F51B5.svg?style=flat-square"
alt="base">
</a>
</div>
<br>
<h3 align="center">
Getting started
</h3>
<br>
2018-10-10 06:49:24 -07:00
To get started with PitchBlack Recovery, you'll need to get
familiar with [Git and Repo](https://source.android.com/source/using-repo.html).
2018-10-10 06:52:32 -07:00
To initialize your local repository using the minimal-manifest-twrp omni trees to build PBRP, use a command like this:
2018-04-01 22:22:43 -07:00
```bash
$ repo init -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b PBRP
2018-04-01 22:22:43 -07:00
```
2018-07-25 03:41:00 -07:00
For Initial Low RAM Devices or older MTK Devices:
2018-04-01 22:22:43 -07:00
```bash
$ repo init -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b twrp-6.0
2018-04-01 22:22:43 -07:00
```
2017-12-19 05:14:48 -08:00
To initialize a shallow clone, which will save even more space, use a command like this:
2018-04-01 22:22:43 -07:00
```bash
2018-11-13 02:37:27 -08:00
$ repo init --depth=1 -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b PBRP
2018-04-01 22:22:43 -07:00
```
2018-04-01 22:20:29 -07:00
For Initial Low RAM Devices:
2018-04-01 22:22:43 -07:00
```bash
$ repo init --depth=1 -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b twrp-6.0
2018-04-01 22:22:43 -07:00
```
For Upgrade Encryption Devices i.e., POCO, Oneplus 6, Using Stock Oreo or Pie
```bash
2019-01-23 05:53:33 -08:00
$ repo init -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b android-9.0
```
Then to sync up:
2018-04-06 07:15:30 -07:00
```bash
2018-10-10 06:51:02 -07:00
$ repo sync
2018-04-06 07:15:30 -07:00
```
omni_device.mk sample
----------
# Inherit from those products. Most specific first.
$(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit.mk) -- only for 64bit phones
# Inherit from device
$(call inherit-product, device/<path>/device.mk) -- path to main device makefile
# Inherit common product files.
$(call inherit-product, vendor/pb/config/common.mk)
# Set those variables here to overwrite the inherited values.
BOARD_VENDOR :=
PRODUCT_BRAND :=
PRODUCT_DEVICE :=
PRODUCT_NAME := omni_device
PRODUCT_MANUFACTURER :=
PRODUCT_MODEL :=
TARGET_VENDOR :=
Then to build:
2018-04-06 07:15:30 -07:00
```bash
2018-10-10 06:49:24 -07:00
2018-10-10 06:51:02 -07:00
$ cd <source-dir>
2018-11-21 06:10:54 -08:00
2018-10-10 06:51:02 -07:00
$ . build/envsetup.sh
2018-11-21 06:10:54 -08:00
2018-10-10 06:51:02 -07:00
$ lunch omni_<device>-eng
2018-11-21 06:10:54 -08:00
2018-10-10 06:51:02 -07:00
$ mka recoveryimage
2018-04-06 07:15:30 -07:00
```
2018-11-13 02:29:08 -08:00
If it fails to build:
```bash
$ export LC_ALL=C
```