Difference between revisions of "GNUstep under Ubuntu Linux"

From GNUstepWiki
Jump to navigation Jump to search
 
(88 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
<pre>
+
Usually it is a good a idea to just use the package manager of your distribution to get a stable and well integrated GNUstep environment:
−
# -----------------------------------------------------------------
 
−
# Objective C 2.0 on Ubuntu (from source)
 
−
# -----------------------------------------------------------------
 
−
# PART 1: LIBOBJC2 from source (with ARC)
 
−
# PART 2: LIBDISPATCH from source
 
−
# ON UBUNTU 12.04 SERVER
 
−
# -----------------------------------------------------------------
 
−
# Step 1 based on David Chisnall (http://etoileos.com/news/archive/2011/08/14/1206/)
 
−
# Step 2 based on Chris Mowforth http://chris.mowforth.com/installing-grand-central-dispatch-on-linux)
 
−
# -----------------------------------------------------------------
 
−
# -----------------------------------------------------------------
 
  
−
# ==============================
+
sudo apt-get install gnustep gnustep-devel
−
# ==============================
 
−
# PART 1: new libobjc2 on Ubuntu
 
−
# ==============================
 
−
# ==============================
 
  
−
# --------------------------------------------------------------------
+
If you want to develop new apps and try the newest features consider the approach described below.
−
# Some examples to test Objective C and ARC once we get it installed
 
−
# --------------------------------------------------------------------
 
  
−
cd ~
+
= Compiling Everything from Scratch  =
  
−
cat > Fraction.h << EOF
+
The following repo contains scripts that  compile and install everything needed for GNUstep Objective-C 2.0.  The script uses clang and libobjc2 for all the awesome new features like ARC, blocks/Grand Central Dispatch, etc.
  
−
#import <Foundation/NSObject.h>
+
For example, to build GNUstep under Ubuntu 19.04, do:
  
−
@interface Fraction: NSObject {
+
git clone https://github.com/plaurent/gnustep-build
−
  int numerator;
+
cd gnustep-build/ubuntu-19.04-clang-8.0-runtime-2.0/
−
  int denominator;
+
./GNUstep-buildon-ubuntu1904.sh
−
}
 
  
−
-(void) print;
+
The demo.sh and demo-gui.sh scripts show example code and compilation examples (using command line as well as the recommended GNUmakefile approach.)
−
-(void) setNumerator: (int) n;
 
−
-(void) setDenominator: (int) d;
 
−
-(int) numerator;
 
−
-(int) denominator;
 
−
@end
 
  
−
EOF
+
Reference manuals for GNUStep, including available APIs, etc, are available at http://www.gnustep.org/developers/documentation.html
  
−
 
+
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-2.0
−
cat > Fraction.m << EOF
+
(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))
−
#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 > main.m << EOF
 
−
 
 
−
#import <stdio.h>
 
−
#import "Fraction.h"
 
−
 
 
−
int main( int argc, const char *argv[] ) {
 
−
  // create a new instance
 
−
  Fraction *frac = [[Fraction alloc] init];
 
−
 
 
−
  // set the values
 
−
  [frac setNumerator: 1];
 
−
  [frac setDenominator: 3];
 
−
 
 
−
  // print it
 
−
  printf( "The fraction is: " );
 
−
  [frac print];
 
−
  printf( "\n" );
 
−
 
 
−
  // free memory
 
−
  [frac release];
 
−
 
 
−
  return 0;
 
−
}
 
−
 
 
−
EOF
 
−
 
 
−
cat > mainarc.m << EOF
 
−
#import <stdio.h>
 
−
#import "Fraction.h"
 
−
 
 
−
int main( int argc, const char *argv[] ) {
 
−
  // create a new instance
 
−
  Fraction *frac = [[Fraction alloc] init];
 
−
 
 
−
  // set the values
 
−
  [frac setNumerator: 1];
 
−
  [frac setDenominator: 3];
 
−
 
 
−
  // print it
 
−
  printf( "The fraction is: " );
 
−
  [frac print];
 
−
  printf( "\n" );
 
−
 
 
−
  // free memory
 
−
  // [frac release];  // valgrind should show less leakage with -fobjc-arc
 
−
 
 
−
  return 0;
 
−
}
 
−
 
 
−
EOF
 
−
 
 
−
 
 
−
# -----------------------------------------------------------------
 
−
# INITIAL REQUIREMENTS
 
−
# -----------------------------------------------------------------
 
−
sudo apt-get -y install build-essential subversion clang libicu-dev libxml2-dev libxml2  libgnutls-dev libssl-dev
 
−
 
 
−
#sudo apt-get -y install gnustep            # If you want old runtime
 
−
#sudo apt-get -y install gnustep-make       
 
−
#sudo apt-get -y install libgnustep-base-dev
 
−
 
 
−
sudo apt-get -y install gobjc                # Def required for below.
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# TEST (may fail w/ segfault if you did not apt-get install gnustep)
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~
 
−
gcc `gnustep-config --objc-flags` main.m  Fraction.m -o test -lobjc -lgnustep-base
 
−
./test
 
−
clang `gnustep-config --objc-flags` main.m  Fraction.m -o test -lobjc -lgnustep-base
 
−
./test
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# OK, let's install the new GNUstep from Subversion repositories!
 
−
# (based on David Chisnall http://etoileos.com/news/archive/2011/08/14/1206/)
 
−
# --------------------------------------------------------------------
 
−
mkdir gs
 
−
cd gs
 
−
 
 
−
svn co svn://svn.gna.org/svn/gnustep/tools/make/trunk make
 
−
svn co http://svn.gna.org/svn/gnustep/modules/core
 
−
svn co svn://svn.gna.org/svn/gnustep/libs/libobjc2/trunk libobjc
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# 1) Install GNUstep Make a first time.
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~/gs/make
 
−
export CC=clang
 
−
export CXX=clang++
 
−
./configure --enable-debug-by-default --with-layout=fhs
 
−
make && sudo -E make install
 
−
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
 
−
cd ..
 
−
 
 
−
cd ~/gs/core/base
 
−
./configure
 
−
make            # On this FIRST TIME THRU, WILL SAY CAN'T BUILD NSBLOCKS for this runtime
 
−
sudo make install
 
−
cd ..
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# TEST (the resulting binary will segfault if we don't have a runtime)
 
−
# --------------------------------------------------------------------
 
−
cd ~
 
−
clang `gnustep-config --objc-flags` main.m  Fraction.m -o test -lobjc -lgnustep-base
 
−
 
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# 2) Build libobjc2
 
−
# --------------------------------------------------------------------
 
−
cd ~/gs/libobjc
 
−
make -f Makefile
 
−
sudo make -f Makefile install
 
−
cd ..
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# 3) NOW GO BACK, RECOMPILE GNUStep MAKE (TO DETECT THE NEW OBJC RUNTIME)
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~/gs/make
 
−
./configure  --enable-objc-nonfragile-abi --enable-native-objc-exceptions --with-layout=fhs --enable-debug-by-default CC=clang CXX=clang++
 
−
make && sudo -E make install
 
−
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
 
−
cd ..
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# 4) AND THEN RECOMPILE CORE/BASE
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~/core/base
 
−
./configure --disable-mixedabi CC=clang CXX=clang++
 
−
make            # THIS TIME THRU, NO COMPLAINTS ABOUT BLOCKS
 
−
sudo make install
 
−
cd ..
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# 5) FINALLY TEST AGAIN AND ENJOY OBJECTIVE C WITH ARC
 
−
# Note that I need to add GNUSTEP-CONFIG --OBJC-LIBS below.
 
−
# If you don't want ARC, omit -fobj-arc
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~
 
−
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobj-arc -fobjc-nonfragile-abi mainarc.m  Fraction.m -o test -lobjc -lgnustep-base
 
−
./test
 
−
 
 
−
 
 
−
 
 
−
# ==============================
 
−
# ==============================
 
−
# PART 2: libdispatch on Ubuntu
 
−
# ==============================
 
−
# ==============================
 
−
 
 
−
 
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# Some examples to test GCD once we get it installed
 
−
# --------------------------------------------------------------------
 
−
 
 
−
cd ~
 
−
 
 
−
cat > helloGCD.c << EOF
 
−
#include <dispatch/dispatch.h>
 
−
#include <stdio.h>
 
−
 
 
−
int main() {
 
−
dispatch_queue_t queue = dispatch_queue_create(NULL, NULL);
 
−
 
 
−
dispatch_sync(queue, ^{
 
−
  printf("Hello, world from a dispatch queue!\n");
 
−
});
 
−
 
 
−
dispatch_release(queue);
 
−
 
 
−
return 0;
 
−
}
 
−
 
 
−
EOF
 
−
 
 
−
cat > helloGCD_objc.c << 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
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# INSTALLING LIBDISPATCH
 
−
# (based on Chris Mowforth http://chris.mowforth.com/installing-grand-central-dispatch-on-linux)
 
−
# --------------------------------------------------------------------
 
−
 
 
−
sudo apt-get install clang libblocksruntime-dev libkqueue-dev
 
−
 
 
−
# Visit  http://packages.ubuntu.com/oneiric/libpthread-workqueue0 for download links
 
−
# Visit  http://packages.ubuntu.com/oneiric/libpthread-workqueue-dev for download link
 
−
 
 
−
mkdir dispatch
 
−
cd dispatch
 
−
sudo apt-get install make autoconf autogen libtool build-essential gcc-multilib
 
−
sudo apt-get install pkg-config
 
−
 
 
−
wget http://mirror.pnl.gov/ubuntu//pool/universe/libp/libpthread-workqueue/libpthread-workqueue0_0.8.2-1_amd64.deb
 
−
wget http://mirror.pnl.gov/ubuntu//pool/universe/libp/libpthread-workqueue/libpthread-workqueue-dev_0.8.2-1_amd64.deb
 
−
 
 
−
sudo dpkg -i libpthread-workqueue0_0.8.2-1_amd64.deb
 
−
sudo dpkg -i libpthread-workqueue-dev_0.8.2-1_amd64.deb
 
−
 
 
−
wget http://archive.ubuntu.com/ubuntu/pool/universe/libd/libdispatch/libdispatch_0~svn197.orig.tar.gz
 
−
 
 
−
tar xvfz libdispatch_0~svn197.orig.tar.gz
 
−
cd libdispatch-0~svn197/
 
−
export CC=clang
 
−
export CXX=clang++
 
−
make distclean
 
−
./configure
 
−
make
 
−
 
 
−
# dispatch_starfish.o: In function `_dispatch_time_mach2nano':
 
−
# dispatch_starfish.c:(.text+0x5bc): undefined reference to `_dispatch_host_time_data'
 
−
# dispatch_starfish.c:(.text+0x5ea): undefined reference to `_dispatch_get_host_time_init'
 
−
# /usr/bin/ld: .libs/dispatch_starfish: hidden symbol `_dispatch_host_time_data' isn't defined
 
−
# /usr/bin/ld: final link failed: Bad value
 
−
# clang: error: linker command failed with exit code 1 (use -v to see invocation)
 
−
# make[1]: *** [dispatch_starfish] Error 1
 
−
# make[1]: Leaving directory `/home/patryk/dispatch/libdispatch-0~svn197/testing'
 
−
# make: *** [all-recursive] Error 1
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# To fix compile, comment out build of "testing" from Makefile
 
−
# --------------------------------------------------------------------
 
−
 
 
−
make clean
 
−
sed "s/testing/#testing/" Makefile > Makefile.new
 
−
mv Makefile.new Makefile
 
−
make
 
−
sudo make install
 
−
sudo ldconfig
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# Testing
 
−
# --------------------------------------------------------------------
 
−
# Plain C: When not compiling with libobjc2 (just plain C) on Ubuntu you must add -lBlocksRuntime
 
−
# --------------------------------------------------------------------
 
−
 
 
−
clang -o hi helloGCD.c -fblocks -ldispatch -lBlocksRuntime
 
−
./hi
 
−
 
 
−
clang -o hi helloGCD.c -fblocks -ldispatch
 
−
# /usr/bin/ld: /tmp/helloGCD-eXxFYY.o: undefined reference to symbol '_NSConcreteGlobalBlock'
 
−
# /usr/bin/ld: note: '_NSConcreteGlobalBlock' is defined in DSO /usr/lib/libBlocksRuntime.so.0
 
−
# so try adding it to the linker command line
 
−
# /usr/lib/libBlocksRuntime.so.0: could not read symbols: Invalid operation
 
−
# clang: error: linker command failed with exit code 1 (use -v to see invocation)
 
−
 
 
−
 
 
−
 
 
−
# --------------------------------------------------------------------
 
−
# Compiling Objective C with ARC and blocks and libdispatch
 
−
# --------------------------------------------------------------------
 
−
# Note: do not use -lBlocksRuntime here since Apple on is not
 
−
# compatible with the libobjc2 one which has its own. (Note from
 
−
# David Chisnall)
 
−
# --------------------------------------------------------------------
 
−
 
 
−
clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -fobj-arc -fobjc-nonfragile-abi -fblocks  helloGCD_objc.m Fraction.m -o test -lobjc -lgnustep-base -ldispatch
 
−
./test
 
−
 
 
−
</pre>
 

Latest revision as of 21:05, 17 April 2022

Usually it is a good a idea to just use the package manager of your distribution to get a stable and well integrated GNUstep environment:

sudo apt-get install gnustep gnustep-devel

If you want to develop new apps and try the newest features consider the approach described below.

Compiling Everything from Scratch

The following repo contains scripts that compile and install everything needed for GNUstep Objective-C 2.0. The script uses clang and libobjc2 for all the awesome new features like ARC, blocks/Grand Central Dispatch, etc.

For example, to build GNUstep under Ubuntu 19.04, do:

git clone https://github.com/plaurent/gnustep-build
cd gnustep-build/ubuntu-19.04-clang-8.0-runtime-2.0/
./GNUstep-buildon-ubuntu1904.sh

The demo.sh and demo-gui.sh scripts show example code and compilation examples (using command line as well as the recommended GNUmakefile approach.)

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

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-2.0 (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))