tutorials - alpine over phone, improve the tutorial by uzeirselot

* made it readable event in text mode only * fix the tutorial, was so centered in androit * provide limitations and issues section * add note about the GLIUBC and such problems
2023-08-25 13:53:16 +02:00 · 2022-07-20 16:42:59 +00:00 · 2022-07-20 16:42:59 +00:00 · dc6f979c01
commit dc6f979c01
parent c44b8ee42d
2 changed files with 109 additions and 28 deletions
--- a/tutorials/community-way/phones-androit-allow-external-apps-install.md
+++ b/tutorials/community-way/phones-androit-allow-external-apps-install.md
@ -0,0 +1,28 @@
+## how to allow install apks on a phone for open source projects
+
+### Android® 8.x & higher
+
+* From a Home screen, swipe up or down from the center of the display to access the apps screen, 
+  or alternative goto the Main screen with all the apps using central button.
+* Navigate: Settings ( the whell with toohs) then Apps
+* Tap Menu icon  (upper-right).
+* Tap Special access
+* Tap Install unknown apps
+* Select the unknown app then tap the Allow from this source switch
+  to turn on Switch on or off Switch off.
+
+### Android® 7.x & lower
+
+* From a Home screen, navigate to Settings
+* Tap Lock screen and security
+* If unavailable, tap Security
+* Tap the Unknown sources switch
+  to turn on or off.
+* If unavailable, Unknown sources
+  to turn on or off. Enabled when check mark is present.
+* To continue, review prompt then tap OK
+
+## See also
+
+* [tutorial-alpine-in-phone](tutorial-alpine-in-phone.md)
+
--- a/tutorials/community-way/tutorial-alpine-in-phone.md
+++ b/tutorials/community-way/tutorial-alpine-in-phone.md
@ -1,35 +1,88 @@
+# Installing ALPINE LINUX on PHONEs

-# INSTALL ALPINE LINUX ON PHONE!
+You must take into consideration that there is really no standar way to replace 
+the phone's operating system, what is really done is to use the base of 
+the operating system and use a parallel operating system 
+(this in principle to explain it more simply).

-## For iOS:
-[Download iSH Shell](https://apps.apple.com/us/app/ish-shell/id1436902243)
->This app provides you Alpine-Linux,thats it!  
-___
+**What happened then?** you can boot inside yor phone (whitout remove the phone's OS), 
+the Alpine operating system, just like a kind of virtual machine but its not!

-## For Android:
-[Download Termux.apk](https://f-droid.org/repo/com.termux_118.apk)
-> If link doesn't work then manually download and install from f-droid.org
->
->Install app,and follow more steps as follows:
+If you want more help directly [ask for help here](../README.md#help-online-directly).

-### To install Alpine-Linux,open termux app and use following command:
-  `pkg install git && curl -LO https://raw.githubusercontent.com/Hax4us/TermuxAlpine/master/TermuxAlpine.sh && bash TermuxAlpine.sh && startalpine`  
->Copy-paste it in termux.
->
->Its successfully installed if no error is seen :)
-___
+## Requirements

-### To logout/exit Alpine-Linux:
-  `exit`  
+1. **IMPORTANT REQUIREMENT** Let's remember that you must have a minimum understanding 
+of Linux terminology, and this does not mean that you know it by using Mint or Ubuntu or WSL2.
+2. Download a terminal subsystem, in the following table we will provide the respectives 
+in each phone cases and feature requirements:
+
+| OS      | Version | Software to download | Minimal storage to use     | Quick link to download                                |
+| ------- | ------- | -------------------- | -------------------------- | ----------------------------------------------------- |
+| iOS     | 12.0+   | Download iSH Shell   | 100Mb (its custom repo)    | https://apps.apple.com/us/app/ish-shell/id1436902243  |
+| Androit | 7.0+    | Download Termux      | 240Mb (depends of version) |  https://f-droid.org/repo/com.termux_118.apk           |
+
+#### Issues when find apps for the phones
+
+* Its best to "Copy-paste" all commands in `Termux` or `iSH` to avoid errors.
+* Its pretty important to check the [Limitations and issues](#limitations-and-issues) section before assume anything.
+* On iOS maybe you must search over App store for the keyword "iSH" if the links provided does not work.
+* On Androit maybe you must enable the **[Allow App Installations from Unknown Sources](phones-androit-allow-external-apps-install.md)**
+
+## Instalation
+
+#### On iOS and iSH
+
+The `iSH` uses the Alpine already embebed, so you may have to run apk update to fetch the Alpine repository list.
+
+The `iSH` has its own repositories so the app is entirely self-contained and iSH with apk can pass app review. 
+The repositories are a pseudo apk filesystem mounted on `/ish/apk` that when read, will actually download 
+from App Store as on-demand resources. It also means that Apple can review all packages in iSH's repositories.
+
+* open `iSH` app
+* After open it, alpine its already started and runing in a terminal mode
+* As optional get sure to get internet network by run `echo "nameserver 8.8.8.8" > /etc/resolv.conf`
+
+#### On Androit and Termux
+
+To install Alpine-Linux:
+
+* open `Termux` app 
+* run following command:
+
+```
+pkg install git
+
+curl -LO https://raw.githubusercontent.com/Hax4us/TermuxAlpine/master/TermuxAlpine.sh && bash TermuxAlpine.sh
+
+startalpine
+```
+
+* To logout/exit Alpine-Linux, just run `exit` until ends
+* To start Alpine-Linux again open `Termux` and run `startalpine`
+* As optional get sure to get internet network by run `echo "nameserver 8.8.8.8" > /etc/resolv.conf`
+
+
+## Limitations and issues
+
+Sometimes you will receive an error `error relocating ... symbol not found` when running any installed tool. 
+This is because you installed some alpine packages too fresh but not upgraded dependences. 
+A simple `apk upgrade -a` will fix it.
+
+**IMPORTANT** to know:
+
+* For `Androit` and `Termux` you must read: https://wiki.termux.com/wiki/Differences_from_Linux
+* For `iOS` and `iSH` you must read: https://github.com/ish-app/ish/wiki/What-works%3F
+
+##  Refrence Sources
+
+* [iSH Github](https://github.com/ish-app/ish)
+* [Termux Github](https://github.com/termux)  
+* [TermuxAlpine Github](https://github.com/Hax4us/TermuxAlpine)
+
+## See also
+
+* [Ask for help here](../README.md#help-online-directly)
+* [About Alpine linux](../../alpine/about.md)

-### To start Alpine-Linux again:  
- `startalpine`  
-___
-[Join our community.Help or discuss with us.](https://t.me/alpine_linux_english)
->https://t.me/alpine_linux_english
-___

-####  *Refrence Sources* :
-[iSH Github](https://github.com/ish-app/ish)
-[Termux Github](https://github.com/termux)  
-[TermuxAlpine Github](https://github.com/Hax4us/TermuxAlpine)