Adding a new program:zh TW

From GeeXboX wiki

新增一個新程式真的很容易，這得感謝我們提供了大部份較難工作的工具集給你使用。

用工具集你甚至不需要編譯器怎麼用、編譯旗標怎麼傳入，也不需要知道怎麼連結 uClibc 函式庫，每件事都會自動完成。

如此一來，只需簡單的照著 新增套件 頁的指示做即可。

底下是新增 nvtv 程式的範例(是的, 這其實已經在 GeeXboX 裡了)

Build 規則

底下兩行是從 nvtv 套件的 build script 取出來的：

#!/bin/sh
. config/options

它引用了 GeeXboX 工具集設定，是非常重要的，所有 script 都要引用。

$SCRIPTS/build toolchain
$SCRIPTS/build pciutils

在繼續建立 nvtv 之前，要求確認 toolchain 及 pciutils 套件已經建立。

cd $BUILD/nvtv*
./configure --host=$TARGET_NAME \
            --build=$HOST_NAME \
            --without-x \
            --without-gtk \
            --with-wx-config=nowx \
            --without-xbox \
            --without-client-backend
make

設定 build script 需要的組態，並開始編譯。

高度建議你將每一個 configure 選項單獨成一行，行末加 \ 字元即可令其視為一行，這樣一來在補丁時會較容易閱讀。

注意 $TARGET_NAME 與 $HOST_NAME 這兩個變數用來傳入 configure。

對每一個套件，這用來告訴它我們要在 uClibc 下建立套件。

你可以瞧瞧 config/path 檔，裡頭有完整的匯出變數列表可以用來傳入編譯 scripts 中。

Install 規則

底下兩行是從 nvtv 套件的 build script 取出來的：

#!/bin/sh
. config/options

它引用了 GeeXboX 工具集設定。

cp $BUILD/nvtv*/src/nvtv $INSTALL/usr/bin

這是編譯好的二進位檔最後要複製到 ISO 檔的地方。

因為 GeeXboX 是一個最小化的散布，只有必須的檔案才複製到 ISO 檔中，所以不要放文件檔或手冊頁。

叫用 install

套件裡的 install script 必須從某處叫用以便在完成 make 命令之後，將所產生的二進位檔置入 ISO 檔。

大體而言， ./scripts/gentree' 正是這個將此套件加入叫用 install script 的地方。

舉例來說，這個檔包含下列片斷：

$SCRIPTS/install linux modules $1
$SCRIPTS/install alsa $1
$SCRIPTS/install tvout $1
...

此外，你也可以從別的 install scripts 中叫用。

在我們的例子中，nvtv 套件的安裝是在 tvout 套件的 install script 中叫用的：

$SCRIPTS/install atitvout
$SCRIPTS/install nvtv
$SCRIPTS/install s3switch
$SCRIPTS/install i810tvout

上面這四個都屬於 tvout 相關套件。

最後，不管你從何處叫用你的套件的 install script，它必須被叫用。如此才能將之加入 ISO 檔中。