XobotOS - Revision history

Bnoffer at 13:29, 23 April 2017

2017-04-23T13:29:00Z

Bnoffer: Fixed section heading 'Building the samples'

2017-04-23T13:27:41Z

Fixed section heading 'Building the samples'

Bnoffer: 1st full version

2017-04-23T13:26:44Z

1st full version

Bnoffer: Added section headlines

2017-04-23T12:32:05Z

Added section headlines

Bnoffer: Completed detailing the setup process

2017-04-23T12:28:14Z

Completed detailing the setup process

Bnoffer at 11:45, 23 April 2017

2017-04-23T11:45:03Z

Bnoffer at 11:44, 23 April 2017

2017-04-23T11:44:38Z

Bnoffer: Created page with "This section of the LiberateOS documentation is dedicated to the foundation of our work: the XobotOS project originaly undertaken by [http://www.xamarin.com Xamarin] and relea..."

2017-04-23T09:05:24Z

Created page with "This section of the LiberateOS documentation is dedicated to the foundation of our work: the XobotOS project originaly undertaken by [http://www.xamarin.com Xamarin] and relea..."

New page

This section of the LiberateOS documentation is dedicated to the foundation of our work: the XobotOS project originaly undertaken by [http://www.xamarin.com Xamarin] and released to the public as open source in early May 2012.

@@ Line 167: / Line 167: @@
 * XobotOS.sln uses the sources from github.
-* XobotOS-debug.sln uses the freshly convereted files from the android/output
+* XobotOS-debug.sln uses the freshly convereted files from the <code>android/output</code> directory.
 === Building the samples ===

@@ Line 170: / Line 170: @@
    directory.
-BUILDING THE SAMPLES:
+=== Building the samples ===
 This is a little bit complicated and still unstable, but here's how it should work:

← Older revision		Revision as of 13:26, 23 April 2017
Line 112:		Line 112:

	== Building XobotOS ==		== Building XobotOS ==
		+
		+	This section is based upon the README.build in the GitHub project.
		+
		+	=== Setting things up ===
		+
		+	You need to create to separate Eclipse workspaces for this and checkout the XobotOS module in each of these.
		+
		+	We are using <code>~/xobotos/sharpen</code> and <code>~/xobotos/build</code> as part of this guide. Now we will check out the project from GitHub:
		+
		+	<nowiki>mkdir ~/xobotos
		+	git clone https://github.com/LiberateOS/XobotOS.git ~/xobotos/sharpen
		+	git clone https://github.com/LiberateOS/XobotOS.git ~/xobotos/build</nowiki>
		+
		+	If you start Eclipse for the first time, then it'll ask you for the workspace directory, select <code>~/xobotos/sharpen</code>. Once it created that, you will be presented with a blank workspace.
		+
		+	In Eclipse, do File / Import / General / Existing Projects into Workspace, select <code>~/xobotos/sharpen</code> as root directory, then it should offer you to import 5 projects. Select sharpen.core and sharpen.xobotos (sharpen.feature and sharpen.site are not used at the moment, and you do not want 'android' in this workspace). Make sure '''not''' to copy them into the workspace, that checkbox must not be checked.
		+
		+	When imported, you should see the 'sharpen.core' and 'sharpen.xobotos' projects.
		+
		+	Select Project / Build automatically.
		+
		+	Open sharpen.xobotos/plugin.xml. At the top of the "Overview" tab, you should see four buttons, the leftmost of these is "Launch an Eclipse application". Click it, and another instance of Eclipse will start.
		+
		+	The first time this inferior instance of Eclipse starts up, it will automatically create a workspace. Once the workspace is loaded do the import as described above, but select the <code>~/xobotos/build/android</code> module.
		+
		+	You are now ready :-)
		+
		+	You only need to follow the instructions in this section the first time that you're running this in Eclipse. Eclipse remembers which projects you had open and your last run configuration, so when you come back, you can simply start Eclipse, then do Run / Run (or Run / Debug to debug it).
		+
		+	=== Running the builder ===
		+
		+	Well, that's easy.
		+
		+	Simply do Project / Build, then get some coffee or take a walk .... ''(normally build automatically is active by default, so Eclipse will start building automatically)''
		+
		+	Current time for a full build is about 10 minutes on my machine.
		+
		+	When done, all the generated sources are placed in the output/ directory and XobotOS-debug.csproj is automatically updated. ''(for some unknown reason this is not happening, so we'll be using the XobotOS.sln instead)''
		+
		+	=== Building the C# sources ===
		+
		+	There is a XobotOS-debug.sln file in the top level directory (/work/test/XobotOS/XobotOS-debug.sln), simply open this in MonoDevelop or use xbuild.
		+
		+	It is highly recommended to close the solution in MonoDevelop before doing a full build.
		+
		+	=== Building the C# sources from GitHub ===
		+
		+	You can also directly compile the C# sources from github:
		+
		+	After checking out or updating, simply open XobotOS.sln in MonoDevelop.
		+
		+	Note that there are two solutions:
		+
		+	* XobotOS.sln uses the sources from github.
		+
		+	* XobotOS-debug.sln uses the freshly convereted files from the android/output
		+	directory.
		+
		+	BUILDING THE SAMPLES:
		+	=====================
		+
		+	This is a little bit complicated and still unstable, but here's how it should work:
		+
		+	Before we can go ahead and build the sources we have to check the linker flag for libpng14 by calling <code>libpng-config --libs</code>. If the result is <code>-libpng</code> we are good to go, but most likely it will be <code>-libpng14</code>. In case it is <code>-libpng14</code> execute the following commands:
		+
		+	<nowiki>cd ~/xobotos/build
		+	find ./ -name '*.gyp' -exec sed -i 's/lpng/lpng14/gI' {} \;</nowiki>
		+
		+	This will update all .gyp files to include libpng14 instead of the default libpng12.
		+
		+	Create a directory called 'build' if it doesn't already exist, cd into that directory, then run
		+
		+	<nowiki>cd .. && python gyp_xobotos</nowiki>
		+
		+	This will generate a Makefile in the build/ directory, running 'make' will build all the native Skia and Android code.
		+
		+	The output gets placed in build/Debug/.
		+
		+	Open XobotOS.sln or XobotOS-debug.sln in MonoDevelop (depending on whether you want to use the sources from github or the newly converted ones, see above) and build the solution.
		+
		+	== References ==
		+
		+	* XobotOS README.build: https://github.com/LiberateOS/XobotOS/blob/master/README.build
		+	* How to Prepare Ubuntu 14.04 LTS Trusty Tahr to Compile Android ROMs: https://forum.xda-developers.com/showthread.php?t=2639611
		+	* Chromium - Linux OpenSuse Build Instructions: https://web-beta.archive.org/web/20120429103223/http://code.google.com/p/chromium/wiki/LinuxOpenSuseBuildInstructions

@@ Line 50: / Line 50: @@
 == Development environment ==
 First of all setup Git by executing the following commands:
@@ Line 57: / Line 59: @@
 Replace "Your Name" and "you@example.com" with your name and E-Mail address as setup on [https://github.com GitHub]. '''Note:''' No sudo this time! These settings apply to your user account directly.
 Now we have to install Eclipse:
@@ Line 65: / Line 69: @@
   <nowiki>sudo apt-get install monodevelop</nowiki>
 Now that all these components are installed we have to add one additional library. XobotOS requires libpng14, but Ubuntu 14.04 LTS provides either libpng12 or libpng16, so we have to install this one manually.
@@ Line 81: / Line 87: @@
 <code>1.4.20</code>
-The last thing we need to do is install proper font support, first we have to install some Microsoft fonts:
+=== Install fonts ===
   <nowiki>sudo apt-get install ttf-mscorefonts-installer</nowiki>
@@ Line 89: / Line 97: @@
   <nowiki>sudo mkdir -p /usr/share/fonts/truetype/ttf-lucida
 sudo find /usr/lib*/jvm/java-*/jre/lib -iname *.ttf -print -exec ln -s {} /usr/share/fonts/truetype/ttf-lucida \;</nowiki>
 The last important step is to increase the memory limits for Eclipse. Open the eclipse.ini with the following command:
@@ Line 100: / Line 110: @@
 Now we are ready to build XobotOS!

← Older revision		Revision as of 12:28, 23 April 2017
Line 48:		Line 48:

	<nowiki>sudo apt-get install git ccache automake lzop bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 g++-multilib python-networkx libxml2-utils bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev squashfs-tools pngcrush schedtool dpkg-dev liblz4-tool make optipng libglu1-mesa-dev libfreetype6-dev</nowiki>		<nowiki>sudo apt-get install git ccache automake lzop bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 g++-multilib python-networkx libxml2-utils bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev squashfs-tools pngcrush schedtool dpkg-dev liblz4-tool make optipng libglu1-mesa-dev libfreetype6-dev</nowiki>
		+
		+	== Development environment ==
		+
		+	First of all setup Git by executing the following commands:
		+
		+	<nowiki>git config --global user.name "Your Name"
		+	git config --global user.email "you@example.com"</nowiki>
		+
		+	Replace "Your Name" and "you@example.com" with your name and E-Mail address as setup on [https://github.com GitHub]. '''Note:''' No sudo this time! These settings apply to your user account directly.
		+
		+	Now we have to install Eclipse:
		+
		+	<nowiki>sudo apt-get install eclipse-cdt eclipse-jdt</nowiki>
		+
		+	And now comes the Mono side of things, install MonoDevelop:
		+
		+	<nowiki>sudo apt-get install monodevelop</nowiki>
		+
		+	Now that all these components are installed we have to add one additional library. XobotOS requires libpng14, but Ubuntu 14.04 LTS provides either libpng12 or libpng16, so we have to install this one manually.
		+
		+	You can download the source tareball from SourceForge [https://sourceforge.net/projects/libpng/files/libpng14/1.4.20/ here] . Download the .tar.gz file and plice it into your home directory on the VM. Afterwards execute the following commands:
		+
		+	<nowiki>sudo cp ~/libpng-1.4.20.tar.gz /usr/src
		+	sudo tar zxf libpng-1.4.20.tar.gz
		+	cd libpng-1.4.20
		+	sudo ./configure
		+	sudo make
		+	sudo make install</nowiki>
		+
		+	If everything went well calling <code>libpng-config --version</code> should return:
		+
		+	<code>1.4.20</code>
		+
		+	The last thing we need to do is install proper font support, first we have to install some Microsoft fonts:
		+
		+	<nowiki>sudo apt-get install ttf-mscorefonts-installer</nowiki>
		+
		+	Accept the end user agreement and the installer will do the rest. Then we need to add the Java 6 fonts to the system fonts. In order to do so execute the following:
		+
		+	<nowiki>sudo mkdir -p /usr/share/fonts/truetype/ttf-lucida
		+	sudo find /usr/lib/jvm/java-/jre/lib -iname *.ttf -print -exec ln -s {} /usr/share/fonts/truetype/ttf-lucida \;</nowiki>
		+
		+	The last important step is to increase the memory limits for Eclipse. Open the eclipse.ini with the following command:
		+
		+	<code>sudo nano /etc/eclipse.ini</code>
		+
		+	At the end replace the two lines starting with <code>-Xms</code> and <code>-Xmx</code> with the following:
		+
		+	<nowiki>-Xms1024m
		+	-Xmx2048m</nowiki>
		+
		+	Now we are ready to build XobotOS!

← Older revision		Revision as of 11:45, 23 April 2017
Line 47:		Line 47:
	Back to a fresh terminal prompt. Install the main build tools with this command:		Back to a fresh terminal prompt. Install the main build tools with this command:

−	<~~code~~>sudo apt-get install git ccache automake lzop bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 g++-multilib python-networkx libxml2-utils bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev squashfs-tools pngcrush schedtool dpkg-dev liblz4-tool make optipng libglu1-mesa-dev libfreetype6-dev</~~code~~>	+	<nowiki>sudo apt-get install git ccache automake lzop bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 g++-multilib python-networkx libxml2-utils bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev squashfs-tools pngcrush schedtool dpkg-dev liblz4-tool make optipng libglu1-mesa-dev libfreetype6-dev</nowiki>

← Older revision		Revision as of 11:44, 23 April 2017
Line 1:		Line 1:
−	This section of the LiberateOS documentation is dedicated to the foundation of our work: the XobotOS project originaly undertaken by [http://www.xamarin.com Xamarin] and released to the public as open source in early May 2012.	+	This section of the LiberateOS documentation is dedicated to the foundation of our work: the XobotOS project originaly undertaken by [http://www.xamarin.com Xamarin] and [https://blog.xamarin.com/android-in-c-sharp/ released to the public] as open source in early May 2012.
		+
		+	The guide presented here is based on the projects official guides posted as part of the various README files on GitHub, but the information has been updated in order to create a proper build environment. You can find a proper list of references at the end of the guide.
		+
		+	== Initial Setup ==
		+
		+	This guide uses Ubuntu 14.04 LTS as a starting point, we recommend setting it up in a virtual machine like Oracle VirtualBox, VMWare Workstaion/Fusion or Parallels Desktop. In the future we will be providing ready made VMs for download.
		+
		+	=== VM requirements ===
		+
		+	Setup a VM with the following parameters:
		+
		+	* At least 2 virtual CPUs/Cores
		+	* At least 6 GB RAM
		+	* At least 50 GB disk space
		+
		+	=== Install Ubuntu ===
		+
		+	Install Ubuntu 14.04 LTS in the i386 version. Using the 64Bit version can lead to library confusion that we want to avoid at this point.
		+
		+	You can download the Network Install ISO file from [http://archive.ubuntu.com/ubuntu/dists/trusty-updates/main/installer-i386/current/images/xenial-netboot/mini.iso here] .
		+
		+	We recommend installing the system in english, but with your proper keyboard layout. Follow the instructions and install the standard Desktop environment. After the initial setup make sure to install the Guest Toold for your virtual machine, so you can properly interact with the VM.
		+
		+	=== Install prerequisites ===
		+
		+	Open a Terminal and install the build environment dependencies.
		+
		+	First we need to install Java 6. In order to do so add a ppa and execute the following command:
		+
		+	<code>sudo add-apt-repository ppa:webupd8team/java</code>
		+
		+	Now you need to install the package.
		+
		+	<code>sudo apt-get update && sudo apt-get install oracle-java6-installer</code>
		+
		+	Check the Java version by executing
		+
		+	<code>java -version</code>
		+
		+	The output should look similar to this:
		+
		+	<nowiki>java version "1.6.0_45"
		+	Java(TM) SE Runtime Environment (build 1.6.0_45-b06)
		+	Java HotSpot(TM) 32-Bit Server VM (build 20.45-b01, mixed mode)</nowiki>
		+
		+	Back to a fresh terminal prompt. Install the main build tools with this command:
		+
		+	<code>sudo apt-get install git ccache automake lzop bison gperf build-essential zip curl zlib1g-dev zlib1g-dev:i386 g++-multilib python-networkx libxml2-utils bzip2 libbz2-dev libbz2-1.0 libghc-bzlib-dev squashfs-tools pngcrush schedtool dpkg-dev liblz4-tool make optipng libglu1-mesa-dev libfreetype6-dev</code>