## Alter Linuxをビルドする
ビルドは実機のArch Linuxを利用する方法とDocker上でビルドする方法があります。  
Dockerでビルドする方法は[この手順](DOCKER.md)を参照してください。  
  
実機でビルドする場合は、OSがArch LinuxかAlter Linuxでなければなりません。  
（Manjaroや他のディストリビューションでも必要なコマンドをインストールすれば理論上は可能ですが動作は保証されません。）
以下では実機でビルドする方法を解説します。  
  
ArchやAlter上で直接ビルドする場合、ビルドはいくつかの方法で行うことができます。

## アーキテクチャについて
現在Alter Linuxは主に`i686`と`x86_64`をサポートしています。限定的に`i486`のサポートも行っています。  
また、現在`aarch64`のサポートもテストされています。  
ビルドを行うホスト環境と互換性のあるアーキテクチャでしかビルドできませんので十分注意してください。  
(x86_64上でi686のビルドはできますがaarh64上でi486のビルドを行うといったことはできません。)  

### 準備

ソースコードを取得します。  

```bash
git clone https://github.com/FascodeNet/alterlinux.git
cd alterlinux
```

Alter Linuxのリポジトリを利用するための鍵を追加します。  

```bash
sudo ./tools/keyring.sh --alter-add --arch32-add
```

ビルドに必要なパッケージをインストールします。

```bash
sudo pacman -S --needed curl dosfstools git libburn libisofs lz4 lzo make pyalpm squashfs-tools libisoburn xz zlib zstd qt5-base
```

### TUIを使用する
`menuconfig`を使用して設定を行いビルドできます。  

```bash
make menuconfig
```

設定が完了したら以下のコマンドでビルドできます

```bash
sudo make build
```

### GUIを使用する
GUIで設定を行ってビルドできます。GUIには`python-gobject`が必須です。  

```bash
python ./tools/build-helper.py
```

### ビルドウィザードを使用する
実機で直接ビルドする場合、wizard.shを使用して簡単に思い通りの設定でビルドできます。  
下記の鍵の追加や依存関係のインストールなどを全て自動で行います。  
bashで書かれていますのでターミナルから実行してください。  
「はい」か「いいえ」の質問は`y`か`n`で応えてください。数値を入力する場合は半角で入力してください。  
ウィザードの使い方の詳細は[公式ブログ](https://blog.fascode.net/2020/04/17/build-alterlinux/)で紹介しています。  

```bash
sudo make wizard
```

### 手動でオプションを指定してビルドする

`build.sh`を実行して下さい。  

```bash
sudo ./build.sh [options] [channel]
```

### build.shの使い方

主なオプションは以下のとおりです。完全なオプションと使い方は`./build -h`を実行して下さい。  
（以下のオプション以外にもデバッグ用の様々なオプションが用意されています。）  

用途 | 使い方
--- | ---
ブートスプラッシュを有効化 | -b
カーネルを変える | -k [kernel]
ユーザ名を変える | -u [username]
パスワードを変更する | -p [password]
日本語にする | -l ja
圧縮方式を変更する | -c [comp type]
圧縮のオプションを設定する | -t [comp option]
出力先ディレクトリを指定する| -o [dir]
作業ディレクトリを指定する | -w [dir]

また引数では設定できない細かい挙動を変更する方法もあります。詳しくは[CONFIG.md](CONFIG.md)を参照してください。  

#### 例
以下の条件でビルドするにはこのようにします。

- Plymouthを有効化
- 圧縮方式は`gzip`
- カーネルは`linux-lts`
- パスワードは`ilovearch`
- チャンネルは`xfce`

```bash
./build.sh -b -c "gzip" -k "lts" -p 'ilovearch' xfce
```


### 注意事項
#### チャンネルについて
チャンネルは、インストールするパッケージと含めるファイルを切り替えます。  
この仕組みにより様々なバージョンのAlter Linuxをビルドすることが可能になります。  
2021年5月07日現在でサポートされているチャンネルは以下のとおりです。  
完全なチャンネルの一覧は`./build.sh -h`を参照して下さい。  

名前 | 目的
--- | ---
basic | 様々なチャンネルの基礎となるGUIの無いチャンネル
cinnamon | 多くのアプリケーションを備えた豪華なシナモンデスクトップのチャンネル
gnome | カスタマイズされたGnomeデスクトップ環境のチャンネル
i3 | i3とカスタマイズ可能なpolybarを搭載したrelengを除いて最も軽量なチャンネル
lxde | LXDEと最小限のアプリケーションのみが入っている軽量なチャンネル
plasma | PlasmaとQtアプリを搭載した現在開発中のチャンネル
releng | 純粋なArchLinuxのライブ起動ディスクをビルドできるチャンネル
serene | Serene Linuxを移植したチャンネル
xfce | デスクトップ環境にXfce4を使用し、様々なソフトウェアを追加したデフォルトのチャンネル
xfce-pro | xfceチャンネルのウィンドウマネージャを変更し、多くのソフトを追加したチャンネル


#### カーネルについて
`i686`アーキテクチャと`x86_64`アーキテクチャでは共にArchLinuxの公式カーネルである`linux`や`linux-lts`、`linux-zen`をサポートしています。  
また`x86_64`では公式カーネルに加えて以下ようなカーネルをサポートしています。  
カーネルの説明は[ArchWiki](https://wiki.archlinux.jp/index.php/%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB)を引用しています。  
AlterISO3からは非公式なカーネルはyayによりコンパイル、インストールされます。カーネルのコンパイルに時間がかかる場合が有るので注意してください。  
この一覧に無いカーネルもサポートしています。完全な一覧は`./build.sh -h`を参照して下さい。  

名前 | 特徴
--- | ---
ck | linux-ck にはシステムのレスポンスを良くするためのパッチが含まれています。
lqx | デスクトップ・マルチメディア・ゲーム用途に Debian 用の設定と ZEN カーネルソースを使ってビルドされたディストロカーネル代替
rt | このパッチを使うことでカーネルのほとんど全てをリアルタイム実行できるようになります。
zen-letsnote | Let's Noteでサスペンドの問題が発生しないようにパッチを当てた`linux-zen`カーネル（Alter Linux独自）

##### 注意
`-k`のオプションは必ず`linux-foo`の`foo`の部分のみを入れてください。例えば`linux-lts`の場合は`lts`が入ります。


#### 圧縮方式について
圧縮方式と詳細のオプションは`mksquashfs`のヘルプを参照してください。
2019年2月12日現在で、`mksquashfs`が対応している方式とオプションは以下の通りです。

```
gzip
    -Xcompression-level <compression-level>
    <compression-level> should be 1 .. 9 (default 9)
    -Xwindow-size <window-size>
    <window-size> should be 8 .. 15 (default 15)
    -Xstrategy strategy1,strategy2,...,strategyN
    Compress using strategy1,strategy2,...,strategyN in turn
    and choose the best compression.
    Available strategies: default, filtered, huffman_only,
    run_length_encoded and fixed
lzma (no options)
lzo
    -Xalgorithm <algorithm>
    Where <algorithm> is one of:
        lzo1x_1
        lzo1x_1_11
        lzo1x_1_12
        lzo1x_1_15
        lzo1x_999 (default)
    -Xcompression-level <compression-level>
    <compression-level> should be 1 .. 9 (default 8)
    Only applies to lzo1x_999 algorithm
lz4
    -Xhc
    Compress using LZ4 High Compression
xz
    -Xbcj filter1,filter2,...,filterN
    Compress using filter1,filter2,...,filterN in turn
    (in addition to no filter), and choose the best compression.
    Available filters: x86, arm, armthumb, powerpc, sparc, ia64
    -Xdict-size <dict-size>
    Use <dict-size> as the XZ dictionary size.  The dictionary size
    can be specified as a percentage of the block size, or as an
    absolute value.  The dictionary size must be less than or equal
    to the block size and 8192 bytes or larger.  It must also be
    storable in the xz header as either 2^n or as 2^n+2^(n+1).
    Example dict-sizes are 75%, 50%, 37.5%, 25%, or 32K, 16K, 8K
    etc.
zstd
    -Xcompression-level <compression-level>
    <compression-level> should be 1 .. 22 (default 15)
```
