Preparativos

Non se poden facer todos os dispositivos para executar Ubuntu Touch. Busque o dispositivo de destino antes de comezar.

To determine your device’s specifications, search for it on GSM Arena and/or Device Specification.

We encourage the following specifications:

Kernel

Ubuntu Touch currently requires a device with a Linux kernel version greater than or equal to 3.15. According to the systemd v255 README, older device kernels are not compatible with systemd v255 or newer. You may learn your device’s kernel version by finding «Kernel Version» in the About page of your Android settings. The kernel version can also be found in the Makefile at the top level of any Linux kernel source tree.

RAM

At least 1GB is required for Operating System to work. 3GB or higher is recommended for a better end-user experience.

Almacenamento

At least 16GB of storage is required. Devices with less storage will likely not have enough space for a full Ubuntu Touch installation.

Localiza guías relevantes e outra información

If your desired target device complies to the above, the next thing to do is locate the available guides and other documentation. This step will help you later on when you run into issues developing your port. For now, the main thing to look for is how to unlock your bootloader. (See below).

Head over to the LineageOS Wiki. Look up your device and read and bookmark the guides that are listed there. Try a web search for additional information, specifying both its retail name and the code name you found on the LineageOS site. Be careful to check that the information you gather applies to your specific device, keeping in mind that many devices are sold in a number of different variants with different hardware specifications.

Another rich source of information is the XDA Developers Forum.

Desbloquee o cargador de arranque

Os vendedores normalmente proporcionan os seus dispositivos nun estado de cargador de arranque bloqueado. Este é un tipo de «selo» de software destinado a evitar modificacións directamente no sistema operativo e no software do sistema. Se desbloqueas o cargador de arranque, poderás facer estas modificacións, pero neste estado a garantía do teu dispositivo pode ser nula. A elección é túa, pero este paso é obrigatorio se desexas instalar Ubuntu Touch no dispositivo.

Os dispositivos difiren e non hai ningún método xeral que abrangue todas as marcas e modelos. Polo tanto, cómpre consultar as mencionadas guías para obter instrucións sobre como desbloquear o cargador de arranque do seu dispositivo en particular.

Instalar recuperación TWRP

You need to install a custom recovery image on your device in order to handle formatting and flashing image files onto it. Head over to the Team Win Recovery Project and locate the image file for your device. Follow the installation instructions provided on the website.

Nota

Some devices do not have a TWRP image available. While it is technically possible to port a device without a recovery, it makes the process a lot more complicated, especially when debugging early in the porting process.

Recomendacións para o PC host / build

The remainder of this guide presumes you are using a build PC running Linux. Although high performance always is nice, stability and sufficient RAM and harddisk space are the main concerns here. You do not need the latest and the best hardware, nor do you need the latest distribution release. In fact, it is not uncommon to run into issues when choosing the very newest release, as some of the software needed may not yet have been built for it. For example, using a Ubuntu LTS release, or a LTS release of another distribution, is often a good choice.

Unha vez completados os pasos anteriores, agora está listo para configurar o seu entorno de compilación e iniciar o proceso de portaxe en si (seguinte sección).