Difference between revisions of "GNUstep under Ubuntu Linux"

From GNUstepWiki
Jump to navigation Jump to search
(add libedit-dev to deal with readline error during lldb compilation)
(41 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Objective C 2.0 on a fresh install of Ubuntu 12.10 Server
+
Objective-C under Ubuntu Linux
  
* Uses llvm/clang source to ensure all the latest features are available.
+
== Compiling Everything from Scratch (Ubuntu 14.04, 15.04) ==
* Also works on Ubuntu 13.10 Desktop.
 
* Includes GUI at the end
 
  
General Notes:
+
The following script compiles and installs everything needed for Objective-C 2.0 from scratch.  The script uses clang and libobjc2 for all the awesome new features like ARC, blocks, etc.
* When compiling, it is generally good to tell clang both the family and version of the runtime: -fobjc-runtime=gnustep-1.7
+
 
  (The current version number can be had by looking at the latest ANNOUNCE filename in http://svn.gna.org/svn/gnustep/libs/libobjc2/trunk/ (e.g., ANNOUNCE.1.7))
+
''(See below for Ubuntu 12.04 help.)
 +
''
 +
 
 +
Reference manuals for GNUStep, including available APIs, etc, are available at http://www.gnustep.org/developers/documentation.html
  
 
<pre>
 
<pre>
# Objective C 2.0 on a fresh install of Ubuntu 12.10 Server
+
#!/bin/bash
 +
 
 +
sudo dpkg --add-architecture i386
 +
sudo apt-get update
 +
sudo apt-get -y install build-essential git subversion ninja cmake libffi-dev libxml2-dev \
 +
libgnutls-dev libicu-dev libblocksruntime-dev libkqueue-dev libpthread-workqueue-dev autoconf libtool \
 +
libjpeg-dev libtiff-dev libffi-dev libcairo-dev libx11-dev:i386 libxt-dev libXft-dev
 +
 
 +
sudo apt-get -y install python-dev libncurses5-dev doxygen swig libedit-dev
  
sudo apt-get install aptitude
 
# Dependencies
 
sudo aptitude -y install build-essential git subversion ninja cmake
 
# Dependencies for GNUStep Base
 
sudo aptitude -y install libffi-dev libxml2-dev libgnutls-dev libicu-dev
 
# Dependencies for libdispatch
 
sudo aptitude -y install libblocksruntime-dev libkqueue-dev libpthread-workqueue-dev autoconf libtool
 
  
 
cd ~
 
cd ~
 
git clone git://github.com/nickhutchinson/libdispatch.git
 
git clone git://github.com/nickhutchinson/libdispatch.git
 
svn co http://svn.gna.org/svn/gnustep/modules/core
 
svn co http://svn.gna.org/svn/gnustep/modules/core
svn co http://svn.gna.org/svn/gnustep/libs/libobjc2/trunk libobjc2
+
git clone https://github.com/gnustep/libobjc2
 +
 
 +
# OBTAIN, COMPILE, INSTALL THE LATEST LLVM/clang. (Doing apt-get install clang instead may or may not work.)
 
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
 
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
 
cd llvm/tools
 
cd llvm/tools
 
svn co http://llvm.org/svn/llvm-project/cfe/trunk clang
 
svn co http://llvm.org/svn/llvm-project/cfe/trunk clang
 
+
svn co http://llvm.org/svn/llvm-project/lldb/trunk lldb
 
cd ~/llvm
 
cd ~/llvm
 +
rm -rf build
 
mkdir build
 
mkdir build
 
cd build
 
cd build
cmake ..
+
cmake -D CMAKE_BUILD_TYPE:STRING=Release ..   # If you don't choose Release, it defaults to Debug which takes lots more space
 
make -j8  # 8=your number of build CPUs
 
make -j8  # 8=your number of build CPUs
 
 
echo "export PATH=\$PATH:~/llvm/build/bin" >> ~/.bashrc
 
echo "export PATH=\$PATH:~/llvm/build/bin" >> ~/.bashrc
 
echo "export CC=clang"  >> ~/.bashrc
 
echo "export CC=clang"  >> ~/.bashrc
 
echo "export CXX=clang++" >> ~/.bashrc
 
echo "export CXX=clang++" >> ~/.bashrc
source ~/.bashrc
+
export PATH=$PATH:~/llvm/build/bin
 +
. ~/.bashrc
 +
 
 +
export CC=clang
 +
export CXX=clang++
 +
 
 
clang -v
 
clang -v
 
clang++ -v
 
clang++ -v
  
 
cd ~/libobjc2
 
cd ~/libobjc2
 +
rm -rf build
 
mkdir build
 
mkdir build
 
cd build
 
cd build
Line 52: Line 62:
 
make && sudo -E make install
 
make && sudo -E make install
 
echo ". /usr/GNUstep/System/Library/Makefiles/GNUstep.sh" >> ~/.bashrc
 
echo ". /usr/GNUstep/System/Library/Makefiles/GNUstep.sh" >> ~/.bashrc
source ~/.bashrc
+
 
 +
. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
  
 
sudo /sbin/ldconfig
 
sudo /sbin/ldconfig
Line 62: Line 73:
  
 
cd ~/libdispatch
 
cd ~/libdispatch
sh autogen.sh
+
rm -rf libdispatch-build
./configure CFLAGS="-I/usr/include/kqueue" LDFLAGS="-lkqueue -lpthread_workqueue -pthread -lm"
+
mkdir libdispatch-build && cd libdispatch-build
 +
../configure
 +
make
 +
sudo make install
 +
sudo ldconfig
 +
 
 +
cd ~/core/gui
 +
./configure
 
make -j8
 
make -j8
 
sudo -E make install
 
sudo -E make install
sudo ldconfig
 
  
# ----------------------------------------------------------------------------------------
+
cd ~/core/back
# TEST COMPILING SOME CODE FROM THE INTERNET
+
./configure
# ----------------------------------------------------------------------------------------
+
make -j8
 +
sudo -E make install
  
You can compile the following code with:
+
echo "Install is done. Open a new terminal or type source ~/.bashrc"
 +
</pre>
  
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobjc-runtime=gnustep -fblocks -fobjc-arc -lobjc  blocktest.m
+
=== Test Code ===
 
 
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobj-arc -fobjc-runtime=gnustep -fblocks -fobjc-arc -lobjc -ldispatch -lgnustep-base  Fraction.m helloGCD_objc.m
 
  
 +
The following is some Objective-C source code from the internet. 
 +
It demonstrates blocks, Grand Central Dispatch, and the use of GNUStep GUI.
  
 +
<pre>
  
 
cat > blocktest.m << EOF
 
cat > blocktest.m << EOF
Line 99: Line 119:
  
 
int main( int argc, const char *argv[] ) {
 
int main( int argc, const char *argv[] ) {
   dispatch_queue_t queue = dispatch_queue_create(NULL, NULL);  
+
   dispatch_queue_t queue = dispatch_queue_create(NULL, NULL);
 
   Fraction *frac = [[Fraction alloc] init];
 
   Fraction *frac = [[Fraction alloc] init];
  
Line 166: Line 186:
  
  
# ------------------------------------------------------
 
# ADDITIONAL OPTIONAL STEPS FOR INSTALLING GUI AND BACK
 
# (i.e., if you're running Ubuntu Desktop)
 
# ------------------------------------------------------
 
  
sudo aptitude install -y libjpeg-dev libtiff-dev
+
cat > guitest.m << EOF
sudo aptitude install -y libcairo-dev libx11-dev:i386 libxt-dev
+
#import <AppKit/AppKit.h>
 +
 
 +
int main()
 +
{
 +
  NSApplication *app;  // Without these 2 lines, seg fault may occur
 +
  app = [NSApplication sharedApplication];
  
cd ~/core/gui
+
  NSAlert * alert = [[NSAlert alloc] init];
./configure
+
  [alert setMessageText:@"Hello alert"];
make -j8
+
  [alert addButtonWithTitle:@"All done"];
sudo -E make install
+
  int result = [alert runModal];
 +
  if (result == NSAlertFirstButtonReturn) {
 +
    NSLog(@"First button pressed");
 +
  }
 +
}
 +
EOF
 +
 
 +
# ======================================================================
 +
# COMPILE USING THE FOLLOWING COMMAND LINES, OR CREATE A MAKEFILE
 +
# ======================================================================
 +
 
 +
# Using COMMAND LINE
  
cd ~/core/back
+
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobjc-runtime=gnustep -fblocks -fobjc-arc -lobjc  blocktest.m
./configure
 
make -j8
 
sudo -E make install
 
  
You can compile the following code with:
+
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobjc-runtime=gnustep -fblocks -lobjc -ldispatch -lgnustep-base  Fraction.m helloGCD_objc.m
  
 
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs`  -fobjc-runtime=gnustep -fblocks -lobjc -fobjc-arc -ldispatch -lgnustep-base -lgnustep-gui  guitest.m
 
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs`  -fobjc-runtime=gnustep -fblocks -lobjc -fobjc-arc -ldispatch -lgnustep-base -lgnustep-gui  guitest.m
  
 +
# Using MAKEFILE
 +
 +
cat > GNUmakefile << EOF
 +
include \$(GNUSTEP_MAKEFILES)/common.make
 +
 +
APP_NAME = GUITest
 +
GUITest_OBJC_FILES = guitest.m
 +
 +
include \$(GNUSTEP_MAKEFILES)/application.make
 +
EOF
 +
 +
make
 +
openapp ./GUITest.app
 +
 +
 +
 +
</pre>
 +
 +
General Note: When compiling your own code, it is generally good to tell clang both the family and version of the runtime: -fobjc-runtime=gnustep-1.8.1
 +
(The current version number can be had by looking at the latest ANNOUNCE filename in https://github.com/gnustep/libobjc2 (e.g., ANNOUNCE.1.8.1))
 +
 +
<b>Ubuntu 12.04 Help</b>
  
 +
On Ubuntu 12.04, the default installed version of CMake is 2.8.7 but you need 2.8.8 or later to compile LLVM.  And the default installed version of GCC and G++ is 4.6 but you need 4.8 or later to compile LLVM.
  
cat > guitest.m << EOF
+
For CMake, the solution is to download and compile CMake yourself. Use the existing CMake 2.8.7 and then replace it:
#import <AppKit/AppKit.h>
 
  
int main()
+
# Download the latest CMake version from the CMake web site (http://www.cmake.org/cmake/resources/software.html), and uncompress it in a folder.
{
+
# Create a _build directory in the CMake sources folder.
NSApplication *app;  // Without these 2 lines, seg fault may occur
+
# From the _build directory, run the following commands to build and install CMake from sources:
app = [NSApplication sharedApplication];
 
  
NSAlert * alert = [[NSAlert alloc] init];
+
<pre>
[alert setMessageText:@"Hello alert"];
+
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
[alert addButtonWithTitle:@"All done"];
+
make
[alert runModal];
+
cpack -G DEB
}
+
sudo apt-get remove cmake cmake-data
EOF
+
sudo dpkg -i cmake*.deb
 +
</pre>
  
 +
To get GCC and G++ 4.8, do the following:
  
 +
<pre>
 +
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
 +
sudo apt-get update
 +
sudo apt-get install gcc-4.8 g++-4.8
 +
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 50
 +
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 50
 
</pre>
 
</pre>
 +
 +
You should be good to go.

Revision as of 02:11, 28 February 2016

Objective-C under Ubuntu Linux

Compiling Everything from Scratch (Ubuntu 14.04, 15.04)

The following script compiles and installs everything needed for Objective-C 2.0 from scratch. The script uses clang and libobjc2 for all the awesome new features like ARC, blocks, etc.

(See below for Ubuntu 12.04 help.)

Reference manuals for GNUStep, including available APIs, etc, are available at http://www.gnustep.org/developers/documentation.html

#!/bin/bash

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get -y install build-essential git subversion ninja cmake libffi-dev libxml2-dev \
libgnutls-dev libicu-dev libblocksruntime-dev libkqueue-dev libpthread-workqueue-dev autoconf libtool \
libjpeg-dev libtiff-dev libffi-dev libcairo-dev libx11-dev:i386 libxt-dev libXft-dev

sudo apt-get -y install python-dev libncurses5-dev doxygen swig libedit-dev


cd ~
git clone git://github.com/nickhutchinson/libdispatch.git
svn co http://svn.gna.org/svn/gnustep/modules/core
git clone https://github.com/gnustep/libobjc2

# OBTAIN, COMPILE, INSTALL THE LATEST LLVM/clang. (Doing apt-get install clang instead may or may not work.)
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
cd llvm/tools
svn co http://llvm.org/svn/llvm-project/cfe/trunk clang
svn co http://llvm.org/svn/llvm-project/lldb/trunk lldb
cd ~/llvm
rm -rf build
mkdir build
cd build
cmake -D CMAKE_BUILD_TYPE:STRING=Release ..    # If you don't choose Release, it defaults to Debug which takes lots more space
make -j8   # 8=your number of build CPUs
echo "export PATH=\$PATH:~/llvm/build/bin" >> ~/.bashrc
echo "export CC=clang"  >> ~/.bashrc
echo "export CXX=clang++" >> ~/.bashrc
export PATH=$PATH:~/llvm/build/bin
. ~/.bashrc

export CC=clang
export CXX=clang++

clang -v
clang++ -v

cd ~/libobjc2
rm -rf build
mkdir build
cd build
cmake ..
make -j8
sudo -E make install

cd ~/core/make
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-nonfragile-abi
make && sudo -E make install
echo ". /usr/GNUstep/System/Library/Makefiles/GNUstep.sh" >> ~/.bashrc

. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh

sudo /sbin/ldconfig

cd ~/core/base/
./configure
make -j8
sudo -E make install

cd ~/libdispatch
rm -rf libdispatch-build
mkdir libdispatch-build && cd libdispatch-build
../configure
make
sudo make install
sudo ldconfig

cd ~/core/gui
./configure
make -j8
sudo -E make install

cd ~/core/back
./configure
make -j8
sudo -E make install

echo "Install is done. Open a new terminal or type source ~/.bashrc"

Test Code

The following is some Objective-C source code from the internet. It demonstrates blocks, Grand Central Dispatch, and the use of GNUStep GUI.


cat > blocktest.m << EOF
#include <stdio.h>

int main() {
    void (^hello)(void) = ^(void) {
        printf("Hello, block!\n");
    };
    hello();
    return 0;
}
EOF

cat > helloGCD_objc.m << EOF

#include <dispatch/dispatch.h>
#import <stdio.h>
#import "Fraction.h"

int main( int argc, const char *argv[] ) {
   dispatch_queue_t queue = dispatch_queue_create(NULL, NULL);
   Fraction *frac = [[Fraction alloc] init];

   [frac setNumerator: 1];
   [frac setDenominator: 3];

   // print it
   dispatch_sync(queue, ^{
     printf( "The fraction is: " );
     [frac print];
     printf( "\n" );
   });
   dispatch_release(queue);

   return 0;
}

EOF

cat > Fraction.h << EOF

#import <Foundation/NSObject.h>

@interface Fraction: NSObject {
   int numerator;
   int denominator;
}

-(void) print;
-(void) setNumerator: (int) n;
-(void) setDenominator: (int) d;
-(int) numerator;
-(int) denominator;
@end

EOF


cat > Fraction.m << EOF
#import "Fraction.h"
#import <stdio.h>

@implementation Fraction
-(void) print {
   printf( "%i/%i", numerator, denominator );
}

-(void) setNumerator: (int) n {
   numerator = n;
}

-(void) setDenominator: (int) d {
   denominator = d;
}

-(int) denominator {
   return denominator;
}

-(int) numerator {
   return numerator;
}
@end

EOF



cat > guitest.m << EOF
#import <AppKit/AppKit.h>

int main()
{
  NSApplication *app;  // Without these 2 lines, seg fault may occur
  app = [NSApplication sharedApplication];

  NSAlert * alert = [[NSAlert alloc] init];
  [alert setMessageText:@"Hello alert"];
  [alert addButtonWithTitle:@"All done"];
  int result = [alert runModal];
  if (result == NSAlertFirstButtonReturn) {
    NSLog(@"First button pressed");
  }
}
EOF

# ======================================================================
# COMPILE USING THE FOLLOWING COMMAND LINES, OR CREATE A MAKEFILE
# ======================================================================

# Using COMMAND LINE

clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobjc-runtime=gnustep -fblocks -fobjc-arc -lobjc  blocktest.m

clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobjc-runtime=gnustep -fblocks -lobjc -ldispatch -lgnustep-base  Fraction.m helloGCD_objc.m

clang `gnustep-config --objc-flags` `gnustep-config --objc-libs`  -fobjc-runtime=gnustep -fblocks -lobjc -fobjc-arc -ldispatch -lgnustep-base -lgnustep-gui  guitest.m

# Using MAKEFILE

cat > GNUmakefile << EOF
include \$(GNUSTEP_MAKEFILES)/common.make

APP_NAME = GUITest
GUITest_OBJC_FILES = guitest.m

include \$(GNUSTEP_MAKEFILES)/application.make
EOF

make
openapp ./GUITest.app



General Note: When compiling your own code, it is generally good to tell clang both the family and version of the runtime: -fobjc-runtime=gnustep-1.8.1 (The current version number can be had by looking at the latest ANNOUNCE filename in https://github.com/gnustep/libobjc2 (e.g., ANNOUNCE.1.8.1))

Ubuntu 12.04 Help

On Ubuntu 12.04, the default installed version of CMake is 2.8.7 but you need 2.8.8 or later to compile LLVM. And the default installed version of GCC and G++ is 4.6 but you need 4.8 or later to compile LLVM.

For CMake, the solution is to download and compile CMake yourself. Use the existing CMake 2.8.7 and then replace it:

  1. Download the latest CMake version from the CMake web site (http://www.cmake.org/cmake/resources/software.html), and uncompress it in a folder.
  2. Create a _build directory in the CMake sources folder.
  3. From the _build directory, run the following commands to build and install CMake from sources:
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
make
cpack -G DEB
sudo apt-get remove cmake cmake-data
sudo dpkg -i cmake*.deb

To get GCC and G++ 4.8, do the following:

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-4.8 g++-4.8
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 50
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 50

You should be good to go.