This repository has been archived by the owner on Dec 28, 2018. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
new: adding a XDA pre-formatted user install guide template
- Loading branch information
1 parent
58c84dd
commit 66e3976
Showing
1 changed file
with
181 additions
and
0 deletions.
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,181 @@ | ||
| [SIZE="5"]About[/SIZE] | ||
|
|
||
| write some beautiful own words here ;) | ||
|
|
||
|
|
||
| [SIZE="5"]Requirements[/SIZE] | ||
|
|
||
| Here are the pre-requirements you have to met! | ||
| If you can't get them: [B][U]Close this page and FORGET it (until the day you met those reqs)![/U][/B] | ||
|
|
||
| Here are the 2 simple requirements you have to met: | ||
|
|
||
| [LIST] | ||
| [*][B]1. root by SuperSU >=v2.76[/B] (greater or equal v2.76) | ||
| --> to test this requirement just start the installer of FIsH with --check (see next lines) which will check for all requirements and abort if its not possible | ||
| --> for many devices - if not all - this means you HAVE TO downgrade/install LL. It also means that you have to upgrade your SuperSU to this version by e.g. FlashFire if you have a lower version installed! | ||
| --> SU by phh is NOT supported => It needs a modified /boot and this would void the boot signing chain! | ||
| --> Magisk is NOT supported => It needs a modified /boot and this would void the boot signing chain! | ||
| --> I will NOT provide downgrading guides there are plenty of them so search and read. | ||
| --> I will NOT provide any guides in rooting your device | ||
| --> Before you think about downgrading to LL read about ANTI-ROLLBACK protection some devices and may have! Anti-Rollback means you CAN NOT downgrade - it would HARD-BRICK your device (wtf thinking the vendors who we are?? Is this even legal?!)! Check that before!! | ||
| [*][B]2. you have to be able to disable SELinux[/B] in your booted Android | ||
| --> You do NOT need to set SELinux [B]permanently[/B] to permissive. Just [B][U]CHECK[/U][/B] if you [B][U]COULD[/U][/B] get it [B][U]MANUALLY[/U][/B]. If you can get it OK. If not.. you obviously have not full root access but check the forums maybe there is something you can do about this. | ||
| --> I will NOT provide any guides enabling SELinux but some lines later you will see how u can execute the very simple check | ||
| --> to test this requirement just start the installer of FIsH with --check (see next lines) which will check for all requirements and abort if its not possible | ||
| [/LIST] | ||
|
|
||
| Those above are hard facts so it may NEVER work with MM. Google has changed the way on how the boot chain will be verified and that means changes in /system will void it from now on. | ||
| If MM can get fully rooted somehow/somewhen on your device with SuperSU installed and you are able to disable SELinux the method will work there as well. | ||
|
|
||
| If you can not meet ALL of the above 2 requirements lay down and cry. | ||
| For the others: calm down and read on! | ||
|
|
||
| [B]You can simply test those both requirements by downloading the FIsH package and execute the installer with the following test parameter: | ||
|
|
||
| [SIZE="4"][/B][COLOR="blue"][B]./install.sh --check[/B][/COLOR][/SIZE] | ||
|
|
||
| This way nothing get installed but you will see if it would work on your device or not. | ||
|
|
||
| [SIZE="5"][COLOR="Red"]Limitations![/COLOR][/SIZE] | ||
|
|
||
| Keep in mind what I said above: FIsH does NOT unlock your bootloader! | ||
| That means with TWRP-in-FIsH you can [B][U]NOT[/U][/B]: | ||
| [LIST] | ||
| [*]Install a custom ROM like CM/Lineage (this will modify boot = SOFT-BRICK) | ||
| [*]Install a custom Kernel (this will modify boot = SOFT-BRICK) | ||
| [*]Install a custom recovery (this will modify recovery = may SOFT-BRICK) | ||
| [*]In short: do nothing which modifies boot or recovery partitions. Those changes will BREAK your boot signing chain. | ||
| [*]You can of course flash everything which is modifying /system /data only (e.g. xposed, Audio mods, etc...) | ||
| [*]You're able to backup and restore as well of course and doing any other modifications which you may can't while the Android system is running. | ||
| [/LIST] | ||
|
|
||
|
|
||
| [U][SIZE="4"]Download[/SIZE][/U] | ||
|
|
||
| READ THE [COLOR="red"][B][U]REQUIREMENTS[/U][/B][/COLOR] above before proceeding! | ||
| Then [B][U][COLOR="red"]UNDERSTAND[/COLOR][/U][/B] the requirements before proceeding! <-- omg this is crucial important!!!! Ensure that you really do not skip this step! | ||
|
|
||
| READ THE [COLOR="red"][B][U]LIMITATIONS[/U][/B][/COLOR] above before proceeding! | ||
| Then [B][U][COLOR="red"]UNDERSTAND[/COLOR][/U][/B] the limitations before proceeding! <-- omg this is crucial important!!!! Ensure that you really do not skip this step! | ||
|
|
||
| ... and [B][U]NEVER[/U][/B] ask for ETA's! ;) | ||
|
|
||
| if you can say: | ||
| [B][I]Yes! I have read and [U]totally[/U] understood the [U]limitations[/U] AND the [U]requirements[/U]![/I][/B] | ||
| then proceed. Otherwise read again until you got it. | ||
| [HIDE]Keep in mind that this is a HACK. It may soft-brick your device. you have been warned! | ||
| The concept is the same for all models but again no guarantees here for anything. | ||
| There is [B][U]ALWAYS[/U][/B] a risk and you should better [B][U]backup[/U][/B] what you do not want to loose before starting downloading this. | ||
|
|
||
| Go to the [B][U]DOWNLOADS[/U][/B] tab in this thread. | ||
| [/HIDE] | ||
|
|
||
| [U][SIZE="4"]Installation (Linux)[/U][/SIZE] | ||
|
|
||
| You can just install any newer version over an old one. | ||
|
|
||
| [LIST=1] | ||
| [*]boot Android and connect USB cable | ||
| [*]download the newest version to your PC and open a terminal in that directory | ||
| [*]tar xzf TWRP-in-FIsH*.tgz | ||
| [*]cd android_FIsH | ||
| [*]./install.sh | ||
| [*]check the output of that script. you should not see any errors there (hopefully) | ||
| [/LIST] | ||
|
|
||
| [U][SIZE="4"]Installation (Windows)[/SIZE] | ||
| [/U] | ||
| use [URL="http://tinyurl.com/FWULatXDA"]FWUL[/URL] or be patient.. maybe i or someone else release an installer... maybe... | ||
|
|
||
|
|
||
| [U][SIZE="4"]First run (no PC required)[/U][/SIZE] | ||
|
|
||
| This FIsH gets installed [B]PERMANENTLY[/B]! That means: | ||
| You can boot up TWRP the same way as described here again without re-installing. | ||
| If you re-install your STOCK image you have to re-install TWRPinFIsH as well. | ||
|
|
||
| [LIST=1] | ||
| [*]reboot Android | ||
| [*]you should now see: LED goes from blue to [U][B][COLOR="green"][U]GREEN[/U][/COLOR][/B][/U] | ||
| [*]NOW [B]directly[/B] when u see this [COLOR="green"][B][U]GREEN[/U][/B][/COLOR] LED press [B]VOLUME DOWN [/B]and [B]do NOT release[/B] | ||
| [*]wait [B]until the device vibrates[/B] and the LED changed to [COLOR="red"][B][U]RED[/U][/B][/COLOR]. Then release the Volume Down button. | ||
| [*]Wait until FIsH completed and TWRP should be shown --> This means FIsH has done it's job well! | ||
| [*]This is a good time to do a full backup isn't it ? ;) Manually mount the SYSTEM partition as it gets not auto mounted atm and do a full backup | ||
| [*]reboot from here (safely ignore the msg "no OS installed" and reboot anyways) and you should see Android booting (hopefully ... if not see bottom) | ||
| [/LIST] | ||
|
|
||
| [U][SIZE="4"]Daily Usage (no PC required)[/U][/SIZE] | ||
|
|
||
| [LIST=1] | ||
| [*]reboot Android | ||
| [*]you should now see: LED goes from blue to [U][B][COLOR="green"][U]GREEN[/U][/COLOR][/B][/U] | ||
| [*]NOW [B]directly[/B] when u see this [COLOR="green"][B][U]GREEN[/U][/B][/COLOR] LED press [B]VOLUME DOWN [/B]and [B]do NOT release[/B] | ||
| [*]wait [B]until the device vibrates[/B] and the LED changed to [COLOR="red"][B][U]RED[/U][/B][/COLOR]. Then release the Volume Down button. | ||
| [*]Wait until FIsH completed and TWRP should be shown --> This means FIsH is doing it's job still very well :) | ||
| [*][COLOR="red"][B][U]AGAIN[/U][/B]: keep your mind up! You HAVE to ensure that whatever you do and whatever you flash -> [B][U]NEVER TOUCH BOOT/RECOVERY[/U][/B]! If you flash a ZIP ensure first that it do not modify them! Otherwise you WILL [U][B]softbrick[/B][/U]. You have been warned (several times now)[/COLOR] | ||
| [/LIST] | ||
|
|
||
| [U][SIZE="4"]Trouble / Bootloop fix[/SIZE] | ||
| [/U]if you encounter a bootloop (should never happen but who knows) you have 3 choices at least: | ||
| [LIST=1] | ||
| [*]Option 1a: (TWRP-Bootloop) Within TWRP open Advanced -> File Manager -> Goto: /system/su.d and click "select" button -> Delete | ||
| Option 1b: (TWRP-Bootloop) From your PC: [COLOR="Blue"]adb shell rm -rf /system/su.d/[/COLOR] | ||
| [B][U]Important[/U][/B]: Catch the fish log (see next topic) | ||
| [*]Option 2 (this works also for a bootloop without twrp): boot into download mode and use [URL="https://github.com/Lekensteyn/lglaf"]LGLaf[/URL] to get a shell | ||
| then: | ||
| [COLOR="Blue"]setenforce 0[/COLOR] <-- if that doesn't work you may have to do a FULL restore to stock | ||
| [COLOR="blue"]mount -oremount,rw /system | ||
| rm -rf /system/su.d/[/COLOR] | ||
| reboot. You are out of the bootloop. | ||
| [B][U]Important[/U][/B]: Catch the fish log (see next topic) | ||
| [*]Option 3: Last resort: Reflash STOCK. sorry.. there is always a risk.. | ||
| [/LIST] | ||
|
|
||
| [U]Catch the FIsH logs[/U][LIST] | ||
| [*]when in TWRP (or other ramdisk providing adb shell): | ||
| [COLOR="Blue"]adb shell "cat /cache/fish/fish.log"[/COLOR] | ||
| [COLOR="Blue"]adb shell "cat /tmp/recovery.log"[/COLOR] | ||
| [*]OR - when in Android: | ||
| [COLOR="Blue"]adb shell "su -c cat /cache/fish/fish.log"[/COLOR] | ||
| [COLOR="Blue"]adb shell "su -c cat /cache/fish/fish.log.old"[/COLOR] | ||
| [COLOR="Blue"]adb shell "su -c tar cvzf recoverylogs.tgz /cache/recovery"[/COLOR] | ||
| [COLOR="Blue"]adb pull recoverylogs.tgz[/COLOR] | ||
| [*]Upload the output to [url]https://paste.omnirom.org[/url] and paste the link in the IRC channel (see next topic) | ||
| [/LIST] | ||
|
|
||
| [U][SIZE="4"]Support / IRC Channel[/SIZE] | ||
| [/U]IRC means Internet Relay Chat and you will get best support here only. | ||
| Choose how to get in: | ||
| [LIST] | ||
| [*][B]PC[/B] ([URL="https://hexchat.github.io/"]HexChat[/URL] and [URL="http://www.pidgin.im/"]Pidgin[/URL] are only 2 of them! This list is not complete!) | ||
| [*][B]Android[/B] ([URL="https://play.google.com/store/apps/details?id=org.yaaic"]Yaaic[/URL], [URL="https://play.google.com/store/apps/details?id=net.andchat"]AndChat[/URL], [URL="https://play.google.com/store/apps/details?id=com.fusionx.lightirc"]HoloIRC[/URL], [URL="https://play.google.com/store/apps/details?id=com.androirc"]AndroIRC[/URL] are only a few of them! This list is not complete!) | ||
| [*][B]Web[/B] ([URL="https://kiwiirc.com/client"]KiwiIRC-Web[/URL],[URL="http://webchat.freenode.net/?channels=Carbon-user"]FreenodeWebchat[/URL]]) | ||
|
|
||
| [*]When you have to choose a channel it is: [B][I]#Carbon-user[/I][/B] | ||
| [*]When you will be asked for a server network choose: [B][I]freenode[/I][/B] | ||
| [/LIST] | ||
|
|
||
| [COLOR="red"][SIZE="4"][B][U]Known issues (may never get fixed)[/U][/B][/SIZE] | ||
| [/COLOR] | ||
| Due to the fact that FIsH is a BRUTAL hijack of the booting process several things may not work as expected. | ||
| This will normally not harm anything but you have to know about. | ||
|
|
||
| [U]ZIP / ROM flashing:[/U] | ||
| omg really you wanna hear that again? OK: DON'T TOUCH BOOT / RECOVERY. And you be safe. | ||
| When you try to install a ROM it will modify at least BOOT. That means soft-brick! | ||
| When you try to install a custom Kernel.. omg really? It will definitively SOFT-BRICK! Maybe you should read the limitations again?? :p | ||
| When you try to install a ZIP like xposed, supersu, Vipermod and others ensure that those are not modifying BOOT or RECOVERY partitions. For those mentioned it would be very unlikely but who knows. | ||
|
|
||
| [U]XXXXXX partition:[/U] | ||
| cannot be mounted - even not manually. You have to live with it. | ||
|
|
||
|
|
||
| [U][SIZE="5"]Credits (without them - no FIsH!!!)[/SIZE][/U] | ||
| If you feel that someone / you is missing on this list lemme know! | ||
| [LIST] | ||
| [*]Chainfire for [URL="https://forum.xda-developers.com/apps/supersu/stable-2016-09-01supersu-v2-78-release-t3452703"]SuperSU[/URL]! This is the main part of FIsH. | ||
| [*]TeamWin for [URL="http://twrp.me"]TWRP[/URL] | ||
| [*]@cray_Doze, @dssmex, @Aaahh and @KeiranFTW for their hijack implementations (e.g. [url]https://forum.xda-developers.com/showthread.php?t=2608408[/url], [URL="https://forum.xda-developers.com/verizon-g4/development/twrp-twrp-lg-g4-bl-locked-untested-t3481967"]first steps to a G4 hijack[/URL]) | ||
| [*]steadfasterX for the [URL="https://forum.xda-developers.com/android/software-hacking/locked-fish-hack-to-boot-want-device-t3578373"]android FIsH [/URL]! ;) | ||
| [/LIST] |