Difference between revisions of "GNUstep under Ubuntu Linux"

From GNUstepWiki
Jump to navigation Jump to search
(→‎16.04, 16.10, & 17.04: --add-architecture i386 # Enable 32-bit repos for libx11-dev:i386)
(Updates for new (mid-2018) GNUstep make parameters and libobjc gnustep 2.0 runtime)
Line 12: Line 12:
  
  
=== 16.04, 16.10, & 17.04===
+
=== Ubuntu 19.04 ===
  
 
In addition to building everything, this script also provides the ability to build the most recent version of four apps: Project Center, Gorm, GWorkspace, and System Preferences.   
 
In addition to building everything, this script also provides the ability to build the most recent version of four apps: Project Center, Gorm, GWorkspace, and System Preferences.   
Line 63: Line 63:
 
# Checkout sources
 
# Checkout sources
 
echo -e "\n\n${GREEN}Checking out sources...${NC}"
 
echo -e "\n\n${GREEN}Checking out sources...${NC}"
git clone https://github.com/nickhutchinson/libdispatch.git
+
#git clone https://github.com/nickhutchinson/libdispatch.git
 +
git clone https://github.com/plaurent/libdispatch.git
 +
cd libdispatch
 +
  git checkout fix_major_missing_symbol_for_ubuntu1904
 +
cd ..
 
git clone https://github.com/gnustep/libobjc2.git
 
git clone https://github.com/gnustep/libobjc2.git
 
git clone https://github.com/gnustep/tools-make.git
 
git clone https://github.com/gnustep/tools-make.git
Line 83: Line 87:
 
echo -e "${GREEN}Building GNUstep-make for the first time...${NC}"
 
echo -e "${GREEN}Building GNUstep-make for the first time...${NC}"
 
cd tools-make
 
cd tools-make
git checkout `git rev-list -1 --first-parent --before=2017-04-06 master` # fixes segfault, should probably be looked at.
+
# git checkout `git rev-list -1 --first-parent --before=2017-04-06 master` # fixes segfault, should probably be looked at.
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-nonfragile-abi --enable-objc-arc
+
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-arc  --with-library-combo=ng-gnu-gnu
 
make -j8
 
make -j8
 
sudo -E make install
 
sudo -E make install
Line 121: Line 125:
 
showPrompt
 
showPrompt
  
OBJCFLAGS="-fblocks -fobjc-runtime=gnustep-1.8.1"
+
OBJCFLAGS="-fblocks -fobjc-runtime=gnustep-1.9"
  
 
# Build GNUstep make second time
 
# Build GNUstep make second time
Line 127: Line 131:
 
echo -e "${GREEN}Building GNUstep-make for the second time...${NC}"
 
echo -e "${GREEN}Building GNUstep-make for the second time...${NC}"
 
cd ../../tools-make
 
cd ../../tools-make
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-nonfragile-abi --enable-objc-arc
+
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-arc --with-library-combo=ng-gnu-gnu
 
make -j8
 
make -j8
 
sudo -E make install
 
sudo -E make install
Line 203: Line 207:
 
</pre>
 
</pre>
  
=== 14.04 & 15.04 ===
+
On older versions of Ubuntu you won't have a recent enough clang. To build clang yourself (instead of apt install clang), use:
  
 
<pre>
 
<pre>
#!/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
 
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
 
cd llvm/tools
 
cd llvm/tools
Line 241: Line 228:
 
export CC=clang
 
export CC=clang
 
export CXX=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"
 
</pre>
 
 
 
=== 12.04 ===
 
 
This uses the same as the 14.04 & 15.04 except there are some additional requirements.
 
 
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:
 
 
# 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.
 
# From the _build directory, run the following commands to build and install CMake from sources:
 
 
<pre>
 
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
 
</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>
 
Now run the 14.04 & 15.04 script.
 
  
 
== Test Code ==
 
== Test Code ==
Line 327: Line 236:
  
 
<pre>
 
<pre>
 +
  
 
cat > blocktest.m << EOF
 
cat > blocktest.m << EOF
Line 439: Line 349:
 
# Using COMMAND LINE
 
# 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` -lobjc  blocktest.m
 +
./a.out
  
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` -lobjc -ldispatch -lgnustep-base  Fraction.m helloGCD_objc.m
 +
./a.out
  
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` -lobjc -fobjc-arc -ldispatch -lgnustep-base -lgnustep-gui  guitest.m
 +
./a.out
  
 
# Using MAKEFILE
 
# Using MAKEFILE
Line 458: Line 371:
 
make
 
make
 
openapp ./GUITest.app
 
openapp ./GUITest.app
 
 
 
 
</pre>
 
</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
+
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))
 
(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))

Revision as of 02:06, 22 April 2019

Objective-C under Ubuntu Linux

Compiling Everything from Scratch

The following scripts 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.

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

NOTE: Unless you have a need for the above features, its recommended to install from the default repos as often the scripts below have issues.

sudo apt install gnustep


Ubuntu 19.04

In addition to building everything, this script also provides the ability to build the most recent version of four apps: Project Center, Gorm, GWorkspace, and System Preferences.

#!/bin/bash

# Show prompt function
function showPrompt()
{
  if [ "$PROMPT" = true ] ; then
    echo -e "\n\n"
    read -p "${GREEN}Press enter to continue...${NC}"
  fi
}

# Set colors
GREEN=`tput setaf 2`
NC=`tput sgr0` # No Color

# Set to true to also build and install apps
APPS=true

# Set to true to pause after each build to verify successful build and installation
PROMPT=true

# Install Requirements
sudo apt update

echo -e "\n\n${GREEN}Installing dependencies...${NC}"

sudo dpkg --add-architecture i386  # Enable 32-bit repos for libx11-dev:i386
sudo apt-get update
sudo apt -y install clang git cmake libffi-dev libxml2-dev \
libgnutls28-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

if [ "$APPS" = true ] ; then
  sudo apt -y install curl
fi

# Create build directory
mkdir GNUstep-build
cd GNUstep-build

# Set clang as compiler
export CC=clang
export CXX=clang++

# Checkout sources
echo -e "\n\n${GREEN}Checking out sources...${NC}"
#git clone https://github.com/nickhutchinson/libdispatch.git
git clone https://github.com/plaurent/libdispatch.git
cd libdispatch
  git checkout fix_major_missing_symbol_for_ubuntu1904
cd ..
git clone https://github.com/gnustep/libobjc2.git
git clone https://github.com/gnustep/tools-make.git
git clone https://github.com/gnustep/libs-base.git
git clone https://github.com/gnustep/libs-gui.git
git clone https://github.com/gnustep/libs-back.git

if [ "$APPS" = true ] ; then
  git clone https://github.com/gnustep/apps-projectcenter.git
  git clone https://github.com/gnustep/apps-gorm.git
  git clone https://github.com/gnustep/apps-gworkspace.git
  git clone https://github.com/gnustep/apps-systempreferences.git
fi

showPrompt

# Build GNUstep make first time
echo -e "\n\n"
echo -e "${GREEN}Building GNUstep-make for the first time...${NC}"
cd tools-make
# git checkout `git rev-list -1 --first-parent --before=2017-04-06 master` # fixes segfault, should probably be looked at.
./configure --enable-debug-by-default --with-layout=gnustep  --enable-objc-arc  --with-library-combo=ng-gnu-gnu
make -j8
sudo -E make install

. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
echo ". /usr/GNUstep/System/Library/Makefiles/GNUstep.sh" >> ~/.bashrc

showPrompt

# Build libdispatch
echo -e "\n\n"
echo -e "${GREEN}Building libdispatch...${NC}"
cd ../libdispatch
rm -Rf build
mkdir build && cd build
../configure  --prefix=/usr
make
sudo make install
sudo ldconfig

showPrompt

# Build libobjc2
echo -e "\n\n"
echo -e "${GREEN}Building libobjc2...${NC}"
cd ../../libobjc2
rm -Rf build
mkdir build && cd build
cmake ../ -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang -DCMAKE_ASM_COMPILER=clang -DTESTS=OFF
cmake --build .
sudo -E make install
sudo ldconfig

export LDFLAGS=-ldispatch

showPrompt

OBJCFLAGS="-fblocks -fobjc-runtime=gnustep-1.9"

# Build GNUstep make second time
echo -e "\n\n"
echo -e "${GREEN}Building GNUstep-make for the second time...${NC}"
cd ../../tools-make
./configure --enable-debug-by-default --with-layout=gnustep --enable-objc-arc --with-library-combo=ng-gnu-gnu
make -j8
sudo -E make install

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

showPrompt

# Build GNUstep base
echo -e "\n\n"
echo -e "${GREEN}Building GNUstep-base...${NC}"
cd ../libs-base/
./configure
make -j8
sudo -E make install

showPrompt

# Build GNUstep GUI
echo -e "\n\n"
echo -e "${GREEN} Building GNUstep-gui...${NC}"
cd ../libs-gui
./configure
make -j8
sudo -E make install

showPrompt

# Build GNUstep back
echo -e "\n\n"
echo -e "${GREEN}Building GNUstep-back...${NC}"
cd ../libs-back
./configure
make -j8
sudo -E make install

showPrompt

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

if [ "$APPS" = true ] ; then
  echo -e "${GREEN}Building ProjectCenter...${NC}"
  cd ../apps-projectcenter/
  make -j8
  sudo -E make install

  showPrompt

  echo -e "${GREEN}Building Gorm...${NC}"
  cd ../apps-gorm/
  make -j8
  sudo -E make install

  showPrompt

  echo -e "\n\n"
  echo -e "${GREEN}Building GWorkspace...${NC}"
  cd ../apps-gworkspace/
  ./configure
  make -j8
  sudo -E make install

  showPrompt

  echo -e "\n\n"
  echo -e "${GREEN}Building SystemPreferences...${NC}"
  cd ../apps-systempreferences/
  make -j8
  sudo -E make install

fi

echo -e "\n\n"
echo -e "${GREEN}Install is done. Open a new terminal to start using.${NC}"

On older versions of Ubuntu you won't have a recent enough clang. To build clang yourself (instead of apt install clang), use:

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++

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` -lobjc  blocktest.m
./a.out

clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -lobjc -ldispatch -lgnustep-base  Fraction.m helloGCD_objc.m
./a.out

clang `gnustep-config --objc-flags` `gnustep-config --objc-libs` -lobjc -fobjc-arc -ldispatch -lgnustep-base -lgnustep-gui  guitest.m
./a.out

# 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-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))