UBports UT installation How-to / Guide d'installation d'UBports UT

libremax

English version (version Française plus bas)

The following procedures have been successfully followed by several users who were experiencing difficulties installing UBports UT on their BQ aquaris M10 tablets. They are also useful for installations on other devices with an adjustment for the boot to fastboot mode (B.9); from a device off (not in standby):

0.1) Press and hold Volume Down and Power buttons simultaneously for:

Fairphone 2,
Nexus 5,
Nexus 7,
Meizu MX4,
Meizu Pro 5

0.2) Press and hold Volume Up and Power buttons simultaneously for:

BQ aquaris 4.5,
BQ aquaris 5.0,
BQ aquaris M10,
OnePlus One,

0.3) Press and hold Volume Up, Volume Down and Power buttons simultaneously for:

Nexus 4

As usual, use the following procedures at your own risk.

Before starting the following procedures, make sure your tablet battery is fully charged (more than 50%).

A. Installing Ubuntu Touch UBports on a BQ Aquaris M10 Ubuntu Edition Tablet with a Ubuntu (64 bits) PC

put your tablet in developer mode via the menu : System settings \ About \ developer mode
in a terminal on the PC, run the command : sudo apt update
in a terminal on the PC, run the command : sudo apt install android-tools-adb android-tools-fastboot (to install the basic tools for android)
in a terminal on the PC, launch the UBports installer (previously downloaded and unarchived, version amd64.deb preferably or amd64.snap) with command : ubports-installer
manually select BQ M10 as device in the installer menu
click on Install
connect the active tablet under Ubuntu Touch, via a USB2 port to the PC
in a terminal on the PC, run the command : sudo adb reboot-bootloader to reboot your tablet in bootloader mode ; a menu appears giving the choice between / reboot system / wipe cache partition / reboot to bootloader / power down / factory reset / view recovery logs. Choose "reboot to bootloader" by selecting with volume + and volume - and pressing the On/Off button; the tablet screen turns black and there is Fastboot Mode at the bottom of the screen.

After installing UBports should start and continue as in the video: https://www.youtube.com/watch?v=zuLFTGkuD68

N.B.: if the installer fails, you can try to lanch the installer (point 4.) with sudo: sudo ubports-installer

B. Installing Ubuntu Touch UBports on a BQ Aquaris M10 Ubuntu Edition Tablet with a Windows PC

put the tablet in developer mode via the menu : System settings \ About \ developer mode
install on the PC, the universal driver adb http://adb.clockworkmod.com or a driver specific to the BQ M10 :
https://www.androidusbdrivers.com/bq-aquaris-m10-usb-drivers/
connect the active tablet under Ubuntu Touch, via a USB2 port to the PC
Allow the PC to access the tablet and mark the checkbox to allow it to be accessed at all times.
change the USB to MTP mode on the PC (by default, only allows charging)
launch the UBports installer for Windows version 1.0.9-beta:
https://github.com/ubports/ubports-installer/releases/download/0.1.9-beta/ubports-installer.0.1.9-beta.exe
Warning, newer versions of the installer do not work for Windows.
manually select BQ M10 as device in the installer menu
click on "Install" in the UBports installer
turn off the BQ M10 Ubuntu Touch tablet, then start it in Fastboot mode, by simultaneously pressing and holding Volume Up and Power buttons ; a menu appears giving the choice between / system reboot / wipe cache partition / reboot to bootloader / power down / factory reset / view recovery logs. Choose "reboot to bootloader" by selecting with volume + and volume - and pressing the On/Off button; the tablet screen turns black and there is Fastboot Mode at the bottom of the screen.

After that, the installation of UBports should start and run as in the video: https://www.youtube.com/watch?v=zuLFTGkuD68

N.B.: If the UBports installer fails, you can try running it with administrator rights (return to point B.6.).

C. Installing UBports Ubuntu Touch on a BQ Aquaris M10 Android Tablet

on the Android tablet, enable developer mode, in Settings/About device : press "Build number" seven times or more to unlock "Developer options". Once done, go back and you will see Developer Options on the screen next to About. Select it.
in the developer mode options, check the "OEM Unlock" box to allow unlocking of the Bootloader
in the developer mode options, select USB debugging
apply the procedure described in this part of the documentation:
https://docs.ubports.com/en/latest/userguide/install.html

At the end you will get a tablet under Ubuntu Touch Canonical version.

upgrade from the Canonical version to the UBports version of Ubuntu Touch,

5.1 if your PC is running Ubuntu, follow procedure A. (see above)
5.2 if your PC is running Windows, follow procedure B. (see above)

French / Français

Les procédures qui suivent ont été appliquées avec succès par plusieurs utilisateurs qui rencontraient des difficultés pour installer UBports UT sur leurs tablettes BQ aquaris M10.
Elles peuvent également être utiles pour les installations sur les autres appareils moyennant une adaptation concernant le passage en mode Fastboot (point B.9) : à partir d'un appareil éteint (pas en veille),

0.1) appuyez simultanément sur les boutons Volume faible et Marche/Arrêt et maintenez-les enfoncés pour :

Fairphone 2,
Nexus 5,
Nexus 7,
Meizu MX4,
Meizu Pro 5

0.2) appuyez simultanément sur les boutons Volume fort et Marche/Arrêt pour :

BQ aquaris 4.5,
BQ aquaris 5.0,
BQ aquaris M10,
OnePlus One,

0.3) appuyez simultanément sur les boutons Volume haut, Volume bas et Marche/Arrêt et maintenez-les enfoncés pour :

Nexus 4

Comme d'habitude, utilisez les procédures qui suivent à vos propres risques et périls

Avant de commencer à suivre les procédures suivantes, assurez vous que votre la batterie de votre tablette est bien chargée (plus de 50%)

A. Installation d'UBports Ubuntu Touch sur une tablette BQ Aquaris M10 Ubuntu Edition avec un PC sous Ubuntu

mettre ta tablette en mode developpeur via le menu : Paramètres système \ A propos de \ mode développeur
dans un terminal sur le PC, lancer la commande : sudo apt update
dans un terminal sur le PC, lancer la commande : sudo apt install android-tools-adb android-tools-fastboot (pour installer les outils de base pour android)
dans un terminal sur le PC, lancer l'installateur UBports (préalablement téléchargé et installé, version amd64.deb de préférence ou amd64.snap) via la commande ubports-installer
sélectionner manuellement BQ M10 comme device dans le menu proposé par l'installeur
cliquer sur Install
connecter la tablette active sous Ubuntu Touch, via un port USB2 au PC
dans un terminal sur le PC, lancer la commande : sudo adb reboot-bootloader pour rebooter ta tablette en mode bootloader ; un menu apparaît donnant le choix entre / reboot système / wipe cache partition / reboot to bootloader / power down / factory reset / view recovery logs. Choisir "reboot to bootloader" en sélectionnant avec volume + et volume - et en validant avec le bouton On/Off ; l'écran de la tablette devient noir et il y a en bas de l'écran noté Fastboot Mode.

Après l'installation d'UBports devrait commencer et se poursuivre comme dans la vidéo: https://www.youtube.com/watch?v=zuLFTGkuD68

B. Installation d'UBports Ubuntu Touch sur une tablette BQ Aquaris M10 Ubuntu Edition avec un PC sous windows

mettre la tablette en mode développeur via le menu : Paramètres système \ A propos de \ mode développeur
installer sur le PC, le driver universel adb http://adb.clockworkmod.com ou bien un driver spécifique à la BQ M10 :
https://www.androidusbdrivers.com/bq-aquaris-m10-usb-drivers/
connecter la tablette active sous Ubuntu Touch, via un port USB2 au PC
autoriser le PC à accéder à la tablette et marquer la case à cocher afin de toujours l'autoriser
changer sur le PC le mode USB à MTP (par défaut, autorise seulement la charge)
lancer l'installeur UBports pour Windows version 1.0.9-beta :
https://github.com/ubports/ubports-installer/releases/download/0.1.9-beta/ubports-installer.0.1.9-beta.exe
Attention, les versions plus récentes de l'installeur ne fonctionnent pas pour Windows.
sélectionner manuellement BQ M10 comme device dans le menu proposé par l'installeur
cliquer sur "Install" dans l'installeur UBports
éteindre la tablette BQ M10 Ubuntu Touch, puis la démarrer en mode Fastboot, en appuyant simultanément sur le bouton Volume + (UP) et sur le bouton On/Off; un menu apparaît donnant le choix entre / reboot system / wipe cache partition / reboot to bootloader / power down / factory reset / view recovery logs. Choisir "reboot to bootloader" en sélectionnant avec volume + et volume - et en validant avec le bouton On/Off ; l'écran de la tablette devient noir et il y a en bas de l'écran noté Fastboot Mode.

Après cela, l'installation d'UBports devrait commencer et se dérouler comme dans la vidéo: https://www.youtube.com/watch?v=zuLFTGkuD68.

NB. Si l'installeur UBports échoue, vous pouvez essayer de le lancer avec les droits d'administrateur. (retourner au point B.6.)

C. Installation d'UBports Ubuntu Touch sur une tablette BQ Aquaris M10 version Android

sur la tablette Android, activer le mode développeur et le débogage USB
dans les options du mode développeur, cocher la case "Déverrouillage OEM" pour autoriser le déverrouillage du Bootloader
appliquer la procédure décrite dans cette partie de la documentation :
https://docs.ubports.com/fr/latest/userguide/install.html
Attention, certains liens vers des logiciels sont actuellement cassés dans la version française alors qu'ils sont valides dans la versions anglaise de la documentation; corrections en attente de publication. Utiliser pour l'instant les liens de la version anglaise quand c'est nécessaire.

Une fois terminé, vous obtenez une tablette sous Ubuntu Touch version Canonical.

pour passer à la version de la version Canonical à la version UBports d'Ubuntu Touch,

4.1 si votre PC est sous Ubuntu, applique la procédure A. (voir plus haut)
4.2 si votre PC est sous windows, appliquer la procédure B. (voir plus haut)

advocatux

@libremax kudos, great how-to!

Just a tip: if you edit your commands and put them between backticks (`) they look better and are easier to separate from the rest of the text

For example this is harder to read

in a terminal on the PC, run the command : sudo apt install android-tools-adb android-tools-fastboot (to install the basic tools for android)

than this

in a terminal on the PC, run the command : sudo apt install android-tools-adb android-tools-fastboot (to install the basic tools for android)

libremax

@advocatux Thanks for the tip: applied

Marathon2422

@advocatux
Makes it easier to copy n paste

I have just put ota-4-RC (2018-W25) on my m10fhd.
To get the adb,to work.
I get developer page on the device,
Then connect to my PC, with a terminal already open,after a few seconds it will bring up the ALLOW connection screen,or i have to enter adb devices in terminal, then start ubports-installer ,then it recognizes my device,and i can adjust what it installs,once i enter my passcode,all is done by the devices.
Just in case you get someone with a problem.

libremax

Add the way to get Fastboot Mode for all UBports supported devices and some other tips.

If you have suggestions for improvement, you are welcome.

wdnp2

Hi
I am still working on installing ubports on my BQ Aquaris M10 HD Ubuntu edition- not given up yet!! I have followed advice on the forum without success.
I have downloaded the deb file extracted it and opened the software install. I checked the permissions.
I get a blue square with install box but when I click the box I get authenticate request and it returns to the blue box page. The installer does not seem to install anything.The tablet is in fastboot and developer modes . I am unable to progress further and would be grateful for your advice.
Regards
Bill

libremax

@wdnp2 Which OS version are you using ?
Generally, Ubuntu 16.04 is recommended.

wdnp2

I have tried the Appimage and deb versions 01.21 that appear on the ubports web site with no luck. I save the files then nothing else happens. I don't think they download properly. I am running Ubuntu 18.04LTS. Any advice?

advocatux

@wdnp2 hi, I've edited your post to make it more readable. You don't need to paste OP's extra-long text to reply btw

advocatux

@wdnp2 I tested the other the day, just for the sake of it, Ubuntu 18.04 + installer (snap, latest) + adb & fastboot tools and the installation worked great (YMMV)

wdnp2

@advocatux
Sorry am new to this. What do you mean by OP and btw?

advocatux

@wdnp2 "original poster" & "by the way"

Lakotaubp

@wdnp2 Op=Original Poster and btw= by the way hope that helps

wdnp2

@advocatux
I click on the deb file on ubports website and a file appears on my computer. I am unable to get any further than another file containing a blue button with install on it!
I have not tried the snap because its new to me and unfamiliar.

Lakotaubp

@advocatux Snap

advocatux

@Lakotaubp

advocatux

@wdnp2 is snapd installed on your computer? Ubuntu 18.04 and Snap packages are a well tested combo.

wdnp2

@advocatux
I get the following
william@LaptopL750:~$ snap install ubports-installer --edge
error: snap "ubports-installer" is not available on edge for this architecture
(i386) but exists on other architectures (amd64).
william@LaptopL750:~$

wdnp2

@wdnp2
Hi
Am still trying to install ubports on my bq aquaris with no success
I installed snapd and tried snp but got nowhere
I am definitely in the correct directory here and get the following
patricia@patricia-R59P-R60P-R61P:~$ sudo dpkg -i ubports-installer_0.1.21-beta_amd64.deb
dpkg: error processing archive ubports-installer_0.1.21-beta_amd64.deb (--install):
package architecture (amd64) does not match system (i386)
Errors were encountered while processing:
ubports-installer_0.1.21-beta_amd64.deb
patricia@patricia-R59P-R60P-R61P:~$

Any further comments?
Many thanks

arubislander

Hi @wdnp2,

The issues you are having is because you are trying to install a 64bit deb package on a 32 bit system.

I am not aware if there are any 32 bit packages floating around somewhere you could try ...