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



  • 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

    1. put your tablet in developer mode via the menu : System settings \ About \ developer mode

    2. in a terminal on the PC, run the command : sudo apt update

    3. 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)

    4. 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

    5. manually select BQ M10 as device in the installer menu

    6. click on Install

    7. connect the active tablet under Ubuntu Touch, via a USB2 port to the PC

    8. 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

    1. put the tablet in developer mode via the menu : System settings \ About \ developer mode

    2. 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/

    3. connect the active tablet under Ubuntu Touch, via a USB2 port to the PC

    4. Allow the PC to access the tablet and mark the checkbox to allow it to be accessed at all times.

    5. change the USB to MTP mode on the PC (by default, only allows charging)

    6. 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.

    7. manually select BQ M10 as device in the installer menu

    8. click on "Install" in the UBports installer

    9. 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

    1. 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.

    2. in the developer mode options, check the "OEM Unlock" box to allow unlocking of the Bootloader

    3. in the developer mode options, select USB debugging

    4. 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.

    1. 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

    1. mettre ta tablette en mode developpeur via le menu : Paramètres système \ A propos de \ mode développeur

    2. dans un terminal sur le PC, lancer la commande : sudo apt update

    3. 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)

    4. 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

    5. sélectionner manuellement BQ M10 comme device dans le menu proposé par l'installeur

    6. cliquer sur Install

    7. connecter la tablette active sous Ubuntu Touch, via un port USB2 au PC

    8. 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

    1. mettre la tablette en mode développeur via le menu : Paramètres système \ A propos de \ mode développeur

    2. 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/

    3. connecter la tablette active sous Ubuntu Touch, via un port USB2 au PC

    4. autoriser le PC à accéder à la tablette et marquer la case à cocher afin de toujours l'autoriser

    5. changer sur le PC le mode USB à MTP (par défaut, autorise seulement la charge)

    6. 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.

    7. sélectionner manuellement BQ M10 comme device dans le menu proposé par l'installeur

    8. cliquer sur "Install" dans l'installeur UBports

    9. é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

    1. sur la tablette Android, activer le mode développeur et le débogage USB

    2. dans les options du mode développeur, cocher la case "Déverrouillage OEM" pour autoriser le déverrouillage du Bootloader

    3. 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.

    1. 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)



  • @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)



  • @advocatux Thanks for the tip: applied



  • @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.



  • 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.



  • 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



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



  • 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?



  • @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 😉



  • @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)



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



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



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



  • @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.



  • @advocatux Snap





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



  • @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
    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



  • 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 ...



  • I couldn't find any 32bit packages. But maybe you could follow the instructions of how to run from source that are described here?

    Or you could try getting access to a 64bit system and trying the regular installer (snap or deb) on there.