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>
|
2013-10-18 04:36:32 -07:00
|
|
|
|
2018-10-10 06:49:24 -07:00
|
|
|
To get started with PitchBlack Recovery, you'll need to get
|
2016-05-30 22:45:27 -07:00
|
|
|
familiar with [Git and Repo](https://source.android.com/source/using-repo.html).
|
2013-10-18 04:36:32 -07:00
|
|
|
|
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
|
2018-10-13 18:32:58 -07:00
|
|
|
$ 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
|
2018-10-13 18:32:58 -07:00
|
|
|
$ 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
|
2018-10-13 18:32:58 -07:00
|
|
|
$ repo init --depth=1 -u git://github.com/PitchBlackRecoveryProject/manifest_pb.git -b twrp-6.0
|
2018-04-01 22:22:43 -07:00
|
|
|
```
|
2018-12-31 08:09:14 -08: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
|
2018-12-31 08:09:14 -08:00
|
|
|
```
|
2013-10-18 04:36:32 -07:00
|
|
|
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
|
|
|
```
|
2019-04-15 02:04:52 -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 :=
|
2013-10-18 04:36:32 -07:00
|
|
|
|
|
|
|
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
|
|
|
|
```
|