Difference between revisions of "WOCE Build Instructions"

From WebOS-Ports
Jump to navigation Jump to search
(Created page with "==Installing Ubuntu== You can download VirtualBox here : https://www.virtualbox.org/wiki/Downloads You can download ISO files to burn Ubuntu CD or DVD here : http://www.ubuntu.c...")
 
Line 1: Line 1:
==Installing Ubuntu==
+
==Supported Platforms==
  
You can download VirtualBox here : https://www.virtualbox.org/wiki/Downloads
+
Currently the only supported platform is Ubuntu 12.04. We have tested and confirmed that x32 and x64 Ubuntu Desktop and Server successfully build WOCE. Other platforms may work but are not supported.
You can download ISO files to burn Ubuntu CD or DVD here : http://www.ubuntu.com/download/ubuntu/download
 
but if you want to spend a litle time for installing Ubuntu in VirtualBox, then use Ubunbu image available here : http://virtualboxes.org/images/ubuntu/
 
After installing your ubuntu image, don't forget to use bridge network configuration in Virtualbox. Then in the Ubuntu console, type  :
 
 
 
sudo apt-get install telnet ssh virtualbox-ose
 
sudo apt-get update
 
sudo apt-get upgrade
 
 
 
In the Ubuntu desktop menu, go in System -> Preferences -> Keyboard -> Layouts tab to change the keyboard type. Then next reboot your ubuntu.  
 
  
 
==Installation on Ubuntu==
 
==Installation on Ubuntu==
Line 80: Line 71:
 
|}
 
|}
  
* 7-Zip version 4.59 or greater is needed
+
If you're uncertain at all, and you're using Ubuntu 12.04, just cut and paste the following.  If they are already installed, they'll be skipped.
* it has been reported that sun-java6-jdk isn't necessary
 
* On Ubuntu 11.04 xar might not install using <code>sudo apt-get install xar</code> See Note 2 Below
 
 
 
If you're uncertain at all, and you're using Ubuntu 11.04, just cut and paste the following.  If they are already installed, they'll be skipped. xar is not included in the code below.
 
  
 
  sudo apt-get install git-core build-essential curl unzip p7zip-full autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison libssl-dev zlib1g-dev libbz2-dev help2man texinfo automake1.10 autopoint xutils-dev cmake
 
  sudo apt-get install git-core build-essential curl unzip p7zip-full autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison libssl-dev zlib1g-dev libbz2-dev help2man texinfo automake1.10 autopoint xutils-dev cmake
Line 90: Line 77:
 
'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.
 
'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.
  
'''Note 2:''' If <code>xar</code> cannot be installed with <code>sudo apt-get install xar</code>, then you have to download two <code>.deb</code>-files manually and install them (in the order they are listed):
+
If you're on a 64-bit system, you will also need to install the ia32-libs package.
* If you're using Ubuntu 11.04:
 
# [http://packages.ubuntu.com/hardy/libxar1 libxar1]
 
# [http://packages.ubuntu.com/hardy/xar xar]
 
* If you're using Debian 6.0.2 (Squeeze):
 
# [http://packages.debian.org/lenny/libxar1 libxar1]
 
# [http://packages.debian.org/lenny/xar xar]
 
  
If you have not xar packages in your repo, then find the files in the previous links and next install manually xar files :
 
sudo dpkg -i libxar1_1.5.1-1_i386.deb xar_1.5.1-1_i386.deb
 
  
After that execute the above command again.
 
  
Use these 2 command line :<BR>
+
====Start setup====
Update repositories  :
 
sudo aptitude update (if it doesn't work use : sudo apt-get update )
 
And next, update the packages :
 
sudo aptitude safe-upgrade (if it doesn't work use : sudo apt-get upgrade )
 
  
If you're on a 64-bit system, you will also need to install the ia32-libs package.
+
*Create a WOCE directory, we recommend you place it in your home directory.
 +
*Clone down the woce-build repo from github. [git://www.github.com/woce/seecretfornow | git://www.github.com/woce/seecretfornow]
 +
*Start the build. this is as simple as cd'ing into the woce-build directory and ruuning '''make''' or if you have multiple cores '''make -j<number of cores here>'''
 +
*When the build finishes the binary's will be under the packages folder in their appropriate directories
  
'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations.  Do not start this if you do not have time for a large download.  Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name.  This will cause the appropriate command to skip that download.  Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.
 
  
====Start setup====
+
==Your Done!==

Revision as of 03:24, 25 June 2012

Supported Platforms

Currently the only supported platform is Ubuntu 12.04. We have tested and confirmed that x32 and x64 Ubuntu Desktop and Server successfully build WOCE. Other platforms may work but are not supported.

Installation on Ubuntu

Prerequisites

Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

git sudo apt-get install git-core
gcc sudo apt-get install build-essential
curl sudo apt-get install curl
unzip sudo apt-get install unzip
7zip * sudo apt-get install p7zip-full
autoconf sudo apt-get install autoconf
subversion sudo apt-get install subversion
libtool sudo apt-get install libtool
wget sudo apt-get install wget
pkg-config sudo apt-get install pkg-config
gettext sudo apt-get install gettext
fakeroot sudo apt-get install fakeroot
javac * sudo apt-get install sun-java6-jdk (if this command line does not work, then do : sudo add-apt-repository ppa:ferramroberto/java; sudo apt-get update; sudo apt-get install sun-java6-jdk )
ant sudo apt-get install ant
cmake sudo apt-get install cmake
xsltproc sudo apt-get install xsltproc
intltool sudo apt-get install intltool
mkimage sudo apt-get install uboot-mkimage
lsdiff sudo apt-get install patchutils
flex sudo apt-get install flex
bison sudo apt-get install bison
libssl-dev sudo apt-get install libssl-dev
zlib1g-dev sudo apt-get install zlib1g-dev
libbz2-dev sudo apt-get install libbz2-dev
xar * sudo apt-get install xar
help2man sudo apt-get install help2man
texinfo sudo apt-get install texinfo
automake 1.10 sudo apt-get install automake1.10
autopoint sudo apt-get install autopoint
xutils-dev sudo apt-get install xutils-dev

If you're uncertain at all, and you're using Ubuntu 12.04, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip p7zip-full autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison libssl-dev zlib1g-dev libbz2-dev help2man texinfo automake1.10 autopoint xutils-dev cmake

Note: If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.

If you're on a 64-bit system, you will also need to install the ia32-libs package.


Start setup

  • Create a WOCE directory, we recommend you place it in your home directory.
  • Clone down the woce-build repo from github. | git://www.github.com/woce/seecretfornow
  • Start the build. this is as simple as cd'ing into the woce-build directory and ruuning make or if you have multiple cores make -j<number of cores here>
  • When the build finishes the binary's will be under the packages folder in their appropriate directories


Your Done!