Difference between revisions of "Template:Luneos build intro"

From WebOS-Ports
Jump to navigation Jump to search
Line 8: Line 8:
 
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 WebOS Ports Open webOS (based on LG's Open webOS operating system). Using these, you can build WebOS Ports Open webOS from source code, and then install it to your device.
 
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 WebOS Ports Open webOS (based on LG's Open webOS operating system). Using these, you can build WebOS Ports Open webOS 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.
+
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.
  
Remember, you assume all risk of trying this, but you will reap the rewards! It’s pretty satisfying to boot into a fresh operating system you compiled yourself at home :) And once you’re an WebOS Ports Open webOS-building expert, there will be no more need to wait for “nightly” builds from anyone. You will have at your fingertips the skills to build a full operating system from code to a running device, whenever you want. From here you maybe want to add a feature, fix a bug, add a translation, or use what you’ve learned to build a new app or port to a new device. Maybe you’ll never build again, but the potential is unlimited!
+
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 WebOS Ports Open webOS-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’ll need===
+
===What you will need===
 
{{Commentlink
 
{{Commentlink
 
|section=what-you'll-need-for-{{{device_name}}}
 
|section=what-you'll-need-for-{{{device_name}}}
Line 18: Line 18:
  
 
* A [[{{{device_codename}}}_Info|{{{device_name}}}]]
 
* A [[{{{device_codename}}}_Info|{{{device_name}}}]]
* A relatively recent computer (Linux, OS X, or Windows) w/a reasonable amount of RAM and about 35 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 relatively recent computer (Linux, OS X, or Windows) w/a reasonable amount of RAM (6GB or more is preferred for building WebKit) and about 35 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
 
* A micro USB cable
 
* A decent Internet connection & reliable power.
 
* 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 <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. 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 [[Doc:_using_virtual_machines|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]. Any recent 64-bit version should work fine, but the latest is recommended.
+
If you are not used to using Linux, this is a good opportunity to learn. It’s free [[Doc:_using_virtual_machines|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.  
  
 
{{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])

Revision as of 13:56, 20 November 2013


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 WebOS Ports Open webOS (based on LG's Open webOS operating system). Using these, you can build WebOS Ports Open webOS 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 WebOS Ports Open webOS-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

[[comment_what-you'll-need-for-{{{device_name}}}|Add a comment to this section]]
  • A [[{{{device_codename}}}_Info|{{{device_name}}}]]
  • A relatively recent computer (Linux, OS X, or Windows) w/a reasonable amount of RAM (6GB or more is preferred for building WebKit) and about 35 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
  • 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 64 bits (amd64) and should work almost everywhere where valid toolchain is provided.

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)