JHBuild a GNOME

Tento část poskytuje návod k sestavení, instalaci a spuštění GNOME.

3.1. Sestavení GNOME

Pro sestavení GNOME jsou vyžadovány některé vývojářské balíčky. Patří k nim:

  • XML DTD DocBook a stylopisy XSLT. Musí být zaregistrované v katalogu XML (/etc/xml/catalog)

  • Knihovny X.

  • libsmbclient z projektu Samba (použito k procházení sítí Windows)

  • libbz2 z bzip2

  • libpng, libjpeg a libtiff (použito k načítání obrázků)

Když instalujete distribuční balíčky, nainstalujte odpovídající balíčky ‚dev‘ nebo ‚devel‘, pokud je to tímto způsobem zavedené ve vaší distribuci. Seznam názvů balíčků je udržován v rámci wiki v projektu GNOME.

3.2. Spuštění jedné aplikace z GNOME

Tato část podrobněji rozebírá, jak spustit jednotlivou aplikaci GNOME. Tato aplikace bude spuštěna v rámci aktuálního pracovního prostředí. Jak spustit aplikaci v rámci GNOME celého sestaveného v JHBuildu viz oddíl Oddíl 3.3 ― Spuštění uživatelského prostředí GNOME.

Spusťte shell z JHBuildu. Bude mít nastavené všechny potřebné proměnné prostředí.

$ jhbuild shell

Ověřte, že bude spuštěna správná aplikace. Například:

$ which gedit
/home/wanda/jhbuild/install/bin/gedit

Spusťte aplikaci:

$ gedit &

Případně spusťte aplikaci pomocí příkazu run:

$ jhbuild run gedit

3.3. Spuštění uživatelského prostředí GNOME

Vytvořte nový uživatelský účet pro běh GNOME sestaveného v JHBuildu. Běh pod jiným uživatelským účtem je doporučován, aby se předešlo problémům způsobeným nastaveními uloženými v domovské složce. Tato příručka v textech pro ilustrační účely používá účet s názvem gnomedev.

Nastavte JHBuild pro nový účet gnomedev. Zkopírujte do domovské složky gnomedev soubory ~/.config/jhbuildrc a ~/.local/bin/jhbuild, nebo pro ně vytvořte symbolické odkazy.

Otevřete terminál jako uživatel gnomedev. Trvale přidejte ~/.local/bin do proměnné PATH následujícím příkazem:

$ echo 'PATH=$PATH:~/.local/bin' >> ~/.bashrc

Otestujte, že JHBuild funguje:

$ jhbuild run pkg-config gtk+-2.0 --modversion
2.20.1

3.3.1. Nastavení GNOME pro spuštění ze správce zobrazení

Sestavte a nainstalujte GNOME pomocí JHBuildu.

Povolte systémové služby. GNOME používá systémového démona D-Bus z /usr/bin a systémové služby z /usr/share/dbus-1/system-services/. GNOME z JHBuildu bude používat démona D-Bus ze sezení JHBuild a služby z ~/jhbuild/install//share/dbus-1/services/. V následujícím příkazu nahreďte ~/jhbuild/install instalačním prefixem GNOME z proměnné prefix:

$ rm -rf ~/jhbuild/install/var/run/dbus
$ ln -s /var/run/dbus ~/jhbuild/install/var/run/dbus
$ rm -rf ~/jhbuild/install/var/lib/dbus/machine-id
$ ln -s /var/lib/dbus/machine-id ~/jhbuild/install/var/lib/dbus/machine-id

Vytvořte spouštěcí skript pro GNOME v /usr/bin/gnome-jhbuild-session následujícím způsobem (~/jhbuild/install nahraďte instalačním prefixem GNOME z proměnné prefix):

#!/bin/sh

GNOME=~/jhbuild/install

GDK_USE_XFT=1
XDG_DATA_DIRS=$XDG_DATA_DIRS:$GNOME/share
XDG_CONFIG_DIRS=$XDG_CONFIG_DIRS:$GNOME/etc/xdg

jhbuild run gnome-session

Nastavte soubor /usr/bin/gnome-jhbuild-session, aby byl spustitelný:

$ chmod a+x /usr/bin/gnome-jhbuild-session

Pro vytvoření záznamu nového sezení ve správci zobrazení vytvořte soubor /usr/share/xsessions/gnome-jhbuild.desktop a zadejte do něj:

[Desktop Entry]
Name=GNOME (JHBuild)
Comment=This session logs you into GNOME testing session
TryExec=/usr/bin/gnome-jhbuild-session
Exec=/usr/bin/gnome-jhbuild-session
Icon=
Type=Application

Restartujte gdm.

3.3.2. Spuštění GNOME ze správce zobrazení

Abyste spustili GNOME sestavené v JHBuildu, nejdříve ve správci zobrazení vyberte sezení GNOME (JHBuild) a pak teprve zadejte přihlašovací údaje uživatele gnomedev. Po úspěšném přihlášení se zobrazí správné prostředí GNOME. Pokud přihlášení není úspěšné, podívejte se do souboru se záznamem. Ten najdete v ~gnomedev/.cache/gdm/session.log nebo v ~gnomedev/.xsession-errors.

3.4. Statická analýza

JHBuild podporuje spuštění statické analýzy na kód v sestavovaných modulech. Tuto možnost zapnete nastavením proměnné static_analyzer v souboru nastavení .jhbuildrc na True.

Po zapnutí se při každém sestavení modulu pomocí JHBuildu zavolá nad sestavením statický analyzátor, který vygeneruje zprávu o problémech, které našel v kódu. Tato zpráva se uloží jako soubory HTML v podsložkách složky /tmp/jhbuild_static_analyzer (ve výchozím stavu, ale cestu lze změnit pomocí proměnné nastavení static_analyzer_outputdir).

Statická analýza v současnosti funguje jen pro moduly používající autotools jako svůj systém pro sestavení. Vyžaduje to mít nainstalovaný program scan-build, i když příkaz, který se má k tomu používat, je možné změnit pomocí proměnné static_analyzer_template v nastavení.