# Hello World (C)

Susanna Huhtanen
ihmis.suski@gmail.com 2012
Tiffany Antopolski
tiffany.antopolski@gmail.com
Une application basique « hello, world »

# How to build, install and create a tar.xz of a Hello World program

          This tutorial will demonstrate how to:

            create a small "Hello, World" application using GTK+
            make the .desktop file
            how to set up the build system

# Create the program

## Bibliothèques à importer

#include <gtk/gtk.h>

## Création de la fenêtre principale de l'application

static void activate (GtkApplication* app, gpointer user_data) { GtkWidget *window;

window = gtk_application_window_new (app); gtk_window_set_title (GTK_WINDOW (window), "Hello World"); gtk_window_set_default_size (GTK_WINDOW (window), 200, 100); gtk_widget_show_all (window); }

GtkApplication initializes GTK+. It also connects the x button that's automatically generated along with the window to the "destroy" signal.

We can start building our first window. We do this by creating a variable called window and assigning it a gtk_application_window_new

The window title can be any string you want it to be. To be on the safe side, it's best to stick to UTF-8 encoding.

Now we have a window which has a title and a working "close" button. Let's add the actual "Hello World" text.

## Étiquette de la fenêtre

GtkWidget *label;

label = gtk_label_new ("Hello World!"); gtk_container_add (GTK_CONTAINER (window), label);

Finally, we create and run the application:

int main (int argc, char **argv) { GtkApplication *app; int status;

app = gtk_application_new (NULL, G_APPLICATION_FLAGS_NONE); g_signal_connect (app, "activate", G_CALLBACK (activate), NULL); status = g_application_run (G_APPLICATION (app), argc, argv); g_object_unref (app);

return status; }

GtkApplicationWindow can only hold one widget at a time. To construct more elaborate programs you need to create a holder widget like GtkGrid inside the window, and then add all the other widgets to it.

## hello-world.c

The complete file:

#include <gtk/gtk.h>

static void activate (GtkApplication* app, gpointer user_data) { GtkWidget *window; GtkWidget *label;

window = gtk_application_window_new (app); label = gtk_label_new ("Hello GNOME!"); gtk_container_add (GTK_CONTAINER (window), label); gtk_window_set_title (GTK_WINDOW (window), "Welcome to GNOME"); gtk_window_set_default_size (GTK_WINDOW (window), 200, 100); gtk_widget_show_all (window); }

int main (int argc, char **argv) { GtkApplication *app; int status;

app = gtk_application_new (NULL, G_APPLICATION_FLAGS_NONE); g_signal_connect (app, "activate", G_CALLBACK (activate), NULL); status = g_application_run (G_APPLICATION (app), argc, argv); g_object_unref (app);

return status; }

## Running the application from terminal

To run this application, first save it as hello-world.c. Then open Terminal, go to the folder where your application is stored.

Compile the program:

    gcc hello-world.c `pkg-config --cflags --libs gtk+-3.0` -o hello-world

Run the program:

    ./hello-world

# The .desktop.in file

Running applications from the Terminal is useful at the beginning of the application making process. To have fully working application integration in GNOME 3 requires a desktop launcher. For this you need to create a .desktop file. The .desktop file describes the application name, the used icon and various integration bits. A deeper insight into the .desktop file can be found here. The .desktop.in file will create the .desktop.

The example shows you the minimum requirements for a `.desktop.in` file.

[Desktop Entry] Version=1.0 Encoding=UTF-8 Name=Hello World Comment=Say Hello Exec=@prefix@/bin/hello-world Icon=application-default-icon Terminal=false Type=Application StartupNotify=true Categories=GNOME;GTK;Utility;

Now let's go through some parts of the `.desktop.in` file.

## Nom

The application name.

## Comment

A short description of the application.

## Exec

Specifies a command to execute when you choose the application from the menu. In this example exec just tells where to find the hello-world file and the file takes care of the rest.

## Terminal

Specifies whether the command in the Exec key runs in a terminal window.

To put your application into the appropriate category, you need to add the necessary categories to the Categories line. More information on the different categories can be found in the menu specification.

In this example we use an existing icon. For a custom icon you need to have a .svg file of your icon, stored in /usr/share/icons/hicolor/scalable/apps. Write the name of your icon file to the .desktop.in file, on line 7. More information on icons in: Installing Icons for Themes and on freedesktop.org: Specifications/icon-theme-spec.

# The build system

Pour que votre application fasse partie intégrante de GNOME 3, vous devez l'installer à l'aide d'autotools. Autotools construit et installe tous les fichiers nécessaires et les place à leurs emplacements corrects.

Auparavant, vous devez posséder les fichiers suivants :

## autogen.sh

#!/bin/sh

set -e

test -n "$srcdir" || srcdir=`dirname "$0"` test -n "$srcdir" || srcdir=.

olddir=`pwd` cd "$srcdir"

# This will run autoconf, automake, etc. for us autoreconf --force --install

cd "$olddir"

if test -z "$NOCONFIGURE"; then "$srcdir"/configure "$@" fi

After the autogen.sh file is ready and saved, run:

    $ chmod +x autogen.sh

## Makefile.am

# The actual runnable program is set to the SCRIPTS primitive. # # Prefix bin_ tells where to copy this bin_PROGRAMS = hello-world hello_world_CFLAGS = $(gtk_CFLAGS) hello_world_LDADD = $(gtk_LIBS) hello_world_SOURCES = hello-world.c

desktopdir = $(datadir)/applications desktop_DATA = \ hello-world.desktop

## configure.ac

# This file is processed by autoconf to create a configure script AC_INIT([Hello World], 1.0) AM_INIT_AUTOMAKE([1.10 no-define foreign dist-xz no-dist-gzip]) AC_PROG_CC AM_PROG_VALAC([0.16]) PKG_CHECK_MODULES(gtk, gtk+-3.0) AC_CONFIG_FILES([Makefile hello-world.desktop])

AC_OUTPUT

## README

Information users should read first. This file can be blank.

When you have the hello-world.c, hello-world.desktop.in, Makefile.am, configure.ac and autogen.sh files with correct information and rights, the README file can include the following instructions:

To build and install this program:

./autogen.sh --prefix=/home/your_username/.local make make install

------------- Running the first line above creates the following files:

aclocal.m4 autom4te.cache config.log config.status configure depcomp hello-world hello-world.desktop hello_world-hello-world.o install-sh missing Makefile.in Makefile

Running "make" links all the appropriate libraries.

Running "make install", installs the application in /home/your_username/.local/bin and installs the hello-world.desktop file in /home/your_username/.local/share/applications

You can now run the application by typing "Hello World" in the Overview.

---------------- To uninstall, type:

make uninstall

---------------- To create a tarball type:

make distcheck

This will create hello-world-1.0.tar.xz