Difference between revisions of "Template:Luneos build intro"
(23 intermediate revisions by 2 users not shown) | |||
Line 7: | Line 7: | ||
− | These instructions will hopefully assist you to start {{#ifeq:{{{device_codename}}}|qemux86| and | with a stock {{{device_name}}}, unlock the bootloader (if necessary), and then}} download the required tools as well as the very latest source code for | + | These instructions will hopefully assist you to start {{#ifeq:{{{device_codename}}}|qemux86| and | with a stock {{{device_name}}}, unlock the bootloader (if necessary), and then}} download the required tools as well as the very latest source code for LuneOS (based on LG's Open webOS/webOS OSE operating system). Using these, you can build LuneOS {{#ifeq:{{{device_codename}}}|qemux86|Emulator|}} from source code {{#ifeq:{{{device_codename}}}|qemux86|.|, and then install it to your device.}} |
It is difficult to say how much experience is necessary to follow these instructions. While this guide is certainly not for the very very very beginner, these steps aren't too hard to follow either. Basic *nix knowledge will help and you should have no difficulties in following the instructions. Others might struggle with the most basic operations. People have different experiences, backgrounds etc therefore, it might be a good idea to read through the instructions to make sure you're comfortable with the steps. | It is difficult to say how much experience is necessary to follow these instructions. While this guide is certainly not for the very very very beginner, these steps aren't too hard to follow either. Basic *nix knowledge will help and you should have no difficulties in following the instructions. Others might struggle with the most basic operations. People have different experiences, backgrounds etc therefore, it might be a good idea to read through the instructions to make sure you're comfortable with the steps. | ||
− | All risk are for yourself, but also the benefits! It’s pretty satisfying to boot into a fresh operating system that you compiled yourself at home :) And once you’re an | + | All risk are for yourself, but also the benefits! It’s pretty satisfying to boot into a fresh operating system that you compiled yourself at home :) And once you’re an LuneOS-building expert, there will be no more need to wait for “nightly” builds from anyone. You can build it yourself from the source code to running it {{#ifeq:{{{device_codename}}}|qemux86|in the VirtualBox Emulator|on a device}}. Now you can add features, fix bugs, add a translation or to build a new app or start porting to a new device! So many new possibilities! |
Line 22: | Line 22: | ||
}}--> | }}--> | ||
− | {{#ifeq: {{{device_codename}}}|qemux86| Oracle VirtualBox | + | {{#ifeq: {{{device_codename}}}|qemux86| Oracle VirtualBox}} |
− | * A [[{{{device_codename}}}_Info|{{{device_name}}}]] {{#ifeq: {{{device_codename}}}|Mako|'''with Android 4.2.2 ONLY, currently no other Android versions are supported!'''}}}} | + | * A [[{{{device_codename}}}_Info|{{{device_name}}}]]{{#ifeq:{{{device_codename}}}|Mako|''' with Android 4.2.2 ONLY (Up to December 31st, 2016, for builds dated January 2017 you will need CyanogenMod 12.1 [https://www.androidfilehost.com/?fid=457095661767139495 cm-12.1-20151007-SNAPSHOT-YOG4PAO334-mako.zip] md5: d2608e95de63e59b14451fce32973748, currently no other Android versions are supported!'''}}{{#ifeq: {{{device_codename}}}|Maguro|''' with Android 4.2.2 ONLY (Up to December 31st, 2016, for builds dated January 2017 you will need CyanogenMod 12.1 [https://www.androidfilehost.com/?fid=817550096634748484 cm-12.1-20160719-SNAPSHOT-YOG7DAO8DL-maguro.zip] md5: afc35c13763d058c380b8b6827118abc, currently no other Android versions are supported!'''}}{{#ifeq: {{{device_codename}}}|Hammerhead|''' You will need CyanogenMod 12.1 ONLY [https://www.androidfilehost.com/?fid=529152257862705351 cm-12.1-20150901-SNAPSHOT-YOG4PAO237-hammerhead.zip] md5: 4ecdbca62a31f9b54f75e28aabe76628,currently no versions are supported!'''}} |
− | * A relatively recent computer (Linux, OS X, or Windows) with a reasonable amount of RAM (6GB or more is preferred for building WebKit) and about | + | |
+ | * A relatively recent computer (Linux, OS X, or Windows) with a reasonable amount of RAM (6GB or more is preferred for building WebKit) and about 70 GB of free storage. The less RAM you have, the longer | ||
+ | the build will take. Using SSDs results in faster builds than traditional hard drives. | ||
{{#ifeq: {{{device_codename}}}|qemux86||* A micro USB cable (or another cable that can connect your device to your computer).}} | {{#ifeq: {{{device_codename}}}|qemux86||* A micro USB cable (or another cable that can connect your device to your computer).}} | ||
* A decent Internet connection & reliable power. | * A decent Internet connection & reliable power. | ||
* Some familiarity with basic Linux operations and terminology. {{#ifeq: {{{device_codename}}}|qemux86||It would help if you’ve installed custom roms on other devices and are familiar with what a recovery image such as ClockworkMod is.}} It may also be useful to know some basic command line concepts such as <code>cd</code> for “change directory”, the concept of directory hierarchies, that in Linux they are separated by <code>/</code>, etc. | * Some familiarity with basic Linux operations and terminology. {{#ifeq: {{{device_codename}}}|qemux86||It would help if you’ve installed custom roms on other devices and are familiar with what a recovery image such as ClockworkMod is.}} It may also be useful to know some basic command line concepts such as <code>cd</code> for “change directory”, the concept of directory hierarchies, that in Linux they are separated by <code>/</code>, etc. | ||
− | If you are not used to using Linux, this is a good opportunity to learn. It’s free [http://www.psychocats.net/ubuntu/virtualbox just download and run a virtual machine (VM)] such as [http://www.virtualbox.org/ VirtualBox], then install a Linux distribution such as [http://www.ubuntu.com/ Ubuntu]. This has been tested on Gentoo (shr-chroot) and Ubuntu-12.04 64 bits (amd64) and should work almost everywhere where valid toolchain is provided. | + | If you are not used to using Linux, this is a good opportunity to learn. It’s free [http://www.psychocats.net/ubuntu/virtualbox just download and run a virtual machine (VM)] such as [http://www.virtualbox.org/ VirtualBox], then install a Linux distribution such as [http://www.ubuntu.com/ Ubuntu]. This has been tested on Gentoo (shr-chroot) and Ubuntu-12.04/13.04/14.04/15.10/16.04 64 bits (amd64) and should work almost everywhere where valid toolchain is provided. |
+ | {{note|note=Create the virtual machine with at least 6GB of RAM (more RAM makes builds faster). Create a "dynamically allocated" virtual disk at least 70GB in size. If you have four processor cores in your host machine, create a VM with 2 CPUs, if six cores, a VM with 4 CPUs, and so forth.}} | ||
{{note|note=You want to use a 64-bit version of Linux.}} | {{note|note=You want to use a 64-bit version of Linux.}} | ||
Using a VM allows Linux to run as a guest inside your host computer; a computer in a computer. If you hate Linux for whatever reason, you can always just uninstall and delete the whole thing. (You can find instruction by [https://www.google.com/search?q=%22VirtualBox+Ubuntu+Windows%22 "Install Ubuntu inside VirtualBox on Windows"] or look [http://www.psychocats.net/ubuntu/virtualbox here for instructions]) | Using a VM allows Linux to run as a guest inside your host computer; a computer in a computer. If you hate Linux for whatever reason, you can always just uninstall and delete the whole thing. (You can find instruction by [https://www.google.com/search?q=%22VirtualBox+Ubuntu+Windows%22 "Install Ubuntu inside VirtualBox on Windows"] or look [http://www.psychocats.net/ubuntu/virtualbox here for instructions]) | ||
+ | |||
+ | {{note|note=If the window for the guest Linux is only 640x480, install "Guest Additions" from the Devices menu. Then, in the VM, click on System Settings, then Displays. Select a better display size.}} |
Revision as of 16:14, 17 July 2019
WARNING: DO NOT EDIT!
THIS PAGE IS NOT A REGULAR WIKI PAGE. IT IS A WIKI *TEMPLATE* AUTO-INCLUDED INTO POTENTIALLY HUNDREDS OF OTHER PAGES. ANY CHANGE MADE HERE WILL AFFECT ALL THESE PAGES SIMULTANEOUSLY, INCLUDING PAGES DEALING WITH MANY TYPES OF DEVICES. SO DO NOT EDIT THIS PAGE UNLESS YOU KNOW EXACTLY WHAT YOU ARE DOING. THANKS!
Introduction
These instructions will hopefully assist you to start with a stock {{{device_name}}}, unlock the bootloader (if necessary), and then download the required tools as well as the very latest source code for LuneOS (based on LG's Open webOS/webOS OSE operating system). Using these, you can build LuneOS from source code , and then install it to your device.
It is difficult to say how much experience is necessary to follow these instructions. While this guide is certainly not for the very very very beginner, these steps aren't too hard to follow either. Basic *nix knowledge will help and you should have no difficulties in following the instructions. Others might struggle with the most basic operations. People have different experiences, backgrounds etc therefore, it might be a good idea to read through the instructions to make sure you're comfortable with the steps.
All risk are for yourself, but also the benefits! It’s pretty satisfying to boot into a fresh operating system that you compiled yourself at home :) And once you’re an LuneOS-building expert, there will be no more need to wait for “nightly” builds from anyone. You can build it yourself from the source code to running it on a device. Now you can add features, fix bugs, add a translation or to build a new app or start porting to a new device! So many new possibilities!
What you will need
- A [[{{{device_codename}}}_Info|{{{device_name}}}]]
- A relatively recent computer (Linux, OS X, or Windows) with a reasonable amount of RAM (6GB or more is preferred for building WebKit) and about 70 GB of free storage. The less RAM you have, the longer
the build will take. Using SSDs results in faster builds than traditional hard drives.
- A micro USB cable (or another cable that can connect your device to your computer).
- A decent Internet connection & reliable power.
- Some familiarity with basic Linux operations and terminology. It would help if you’ve installed custom roms on other devices and are familiar with what a recovery image such as ClockworkMod is. It may also be useful to know some basic command line concepts such as
cd
for “change directory”, the concept of directory hierarchies, that in Linux they are separated by/
, etc.
If you are not used to using Linux, this is a good opportunity to learn. It’s free just download and run a virtual machine (VM) such as VirtualBox, then install a Linux distribution such as Ubuntu. This has been tested on Gentoo (shr-chroot) and Ubuntu-12.04/13.04/14.04/15.10/16.04 64 bits (amd64) and should work almost everywhere where valid toolchain is provided.
Note:
Create the virtual machine with at least 6GB of RAM (more RAM makes builds faster). Create a "dynamically allocated" virtual disk at least 70GB in size. If you have four processor cores in your host machine, create a VM with 2 CPUs, if six cores, a VM with 4 CPUs, and so forth.
Note:
You want to use a 64-bit version of Linux.
Using a VM allows Linux to run as a guest inside your host computer; a computer in a computer. If you hate Linux for whatever reason, you can always just uninstall and delete the whole thing. (You can find instruction by "Install Ubuntu inside VirtualBox on Windows" or look here for instructions)
Note:
If the window for the guest Linux is only 640x480, install "Guest Additions" from the Devices menu. Then, in the VM, click on System Settings, then Displays. Select a better display size.