Android + Termux による Git ワークフロー構築
Android スマートフォンから GitHub リポジトリへファイルを配置・コミット・プッシュする実用的な手順と、それをワンコマンド化するスクリプトの構築記録。
背景と目的
デスクトップから離れた環境で、Git リポジトリに対して以下を実現したい:
- モバイル端末からリポジトリの特定ディレクトリへファイル/フォルダを追加する
- 追加後、pull → add → commit → push までを一貫して自動化する
- 追加対象は HTML/JS で構成される小規模ツール類(ゲーム、ユーティリティ等)
- 手順は再現可能で、複数プロジェクトに使い回せること
「Dropbox 感覚での自動同期」は Git の仕組み上できないが、明示的な1コマンドで同期完了というレベルには到達できる。
手段の比較
| 手段 | 長所 | 短所 |
|---|---|---|
| GitHub 公式モバイルアプリ | 手軽 | 単一ファイル編集のみ、アップロード不可 |
| github.dev (ブラウザ版 VS Code) | GUI で完結、コマンド不要 | ターミナル不可、Android では zip 等バイナリのアップロードに制約 |
| Working Copy (iOS) | GUI で高機能 | iOS 専用、Push は有料 |
| Termux (Android) | フル Linux 環境、あらゆる操作が可能 | 初期セットアップが必要 |
Android で本格運用するなら Termux が最も柔軟。以降 Termux を前提に構築する。
github.dev の Android 制約について
ブラウザ版 VS Code (github.dev) は多くの操作が GUI で完結するが、Android 環境では以下の制約がある:
- ファイル選択ダイアログが画像しか選ばせないケースがある(Android のファイル選択挙動 +
<input accept>の解釈による) - ドラッグ&ドロップは基本的に不可(デスクトップ環境向け機能)
- ターミナルが使えないため、アップロード後の解凍・移動ができない
回避策として拡張子偽装(zip を png にリネーム)を検討したが、アップロード後に展開する手段が存在しないため無意味。テキスト編集中心なら github.dev で十分だが、バイナリや複数ファイルを扱うなら Termux が必要。
Termux セットアップ
インストール
Google Play 版は更新が停止しているため、F-Droid 版または GitHub Releases 版を使用する。
- F-Droid: https://f-droid.org/packages/com.termux/
- GitHub Releases: https://github.com/termux/termux-app/releases
初期化コマンド
# パッケージ更新pkg update -y && pkg upgrade -y
# 必要ツールを一括インストールpkg install -y git openssh unzip nano
# Android 共有ストレージへのアクセス権を付与termux-setup-storagetermux-setup-storage 実行時に権限ダイアログが出るので許可する。これで ~/storage/ 配下から共有ストレージにアクセスできるようになる。
GitHub 認証設定
Personal Access Token (PAT) を発行:
- GitHub にログイン
- Settings → Developer settings → Personal access tokens → Tokens (classic)
- Generate new token (classic)
- Scope で
repoにチェック - トークン文字列をコピー(表示は1回のみ)
Git 設定:
git config --global user.name "your-username"git config --global user.email "your-email@example.com"
# 認証情報を保存(初回入力後は自動)git config --global credential.helper store
# pull はデフォルトで rebase(履歴を直線的に保つ)git config --global pull.rebase true初回 git push 時にユーザー名と PAT を求められる。PAT を貼り付ければ以降は自動化される。
PAT の運用について
- 同一アカウントのすべてのリポジトリで同じ PAT が使い回せる(
repoスコープ付与の場合) - 別プロジェクトを clone するときも追加発行は不要
- PAT は
~/.git-credentialsに平文保存されるため、端末を手放す前に削除する - 漏洩時は GitHub 側で即 Revoke(無効化)
- 高セキュリティ運用なら Fine-grained token(リポジトリ単位で権限を絞る、個別発行)
ディレクトリ構造の把握
git clone した実体は Termux 専用領域に配置される:
/data/data/com.termux/files/home/your-repo/これは $HOME(~)と同じ。特徴:
- 他のアプリからは基本的に見えない(Android のサンドボックス)
- 通常のファイルマネージャからも不可視
- Termux をアンインストールすると消える
~/storage/shared/などは共有ストレージへのシンボリックリンク
Git 操作の安定性の観点から、リポジトリ本体は Termux ホーム側に置き、素材の受け渡しに共有ストレージを使う構成が推奨される。
ワンコマンド化スクリプト
設計要件
- 配置元:
/storage/emulated/0/Documents/dev/(または~/storage/shared/Documents/dev/) - 配置先: リポジトリ内の任意サブディレクトリ(本例では
public/tools/) - 引数: ファイル名またはディレクトリ名を1つ以上
.zip引数は自動解凍、ディレクトリはそのままコピー、単一ファイルもコピー- 実行1回で pull → 配置 → add → commit → push を完了
.zip に固める必要は必ずしもない。Termux は cp -r でフォルダごとコピーできるため、素材はフォルダのまま置くほうが手数が少ない。zip サポートは配布物を受け取ったときの利便性として残す。
スクリプト本体
#!/data/data/com.termux/files/usr/bin/bash# File: deploy-tool# Usage: deploy-tool <name1> [name2] ...# name は SRC_DIR 配下のファイル名 or ディレクトリ名
set -e
SRC_DIR="/storage/emulated/0/Documents/dev"REPO_DIR="$HOME/your-repo"DEST_SUBDIR="public/tools"DEST_DIR="$REPO_DIR/$DEST_SUBDIR"BRANCH="main"
if [ $# -eq 0 ]; then echo "Usage: deploy-tool <name1> [name2] ..." exit 1fi
if [ ! -d "$REPO_DIR/.git" ]; then echo "Error: repository not found at $REPO_DIR" exit 1fi
mkdir -p "$DEST_DIR"
echo "==> git pull"cd "$REPO_DIR"git pull --rebase origin "$BRANCH"
DEPLOYED=()for name in "$@"; do src="$SRC_DIR/$name"
if [ ! -e "$src" ]; then echo "Warning: $src not found, skip" continue fi
echo "==> processing: $name"
if [[ "$name" == *.zip ]]; then base="${name%.zip}" target="$DEST_DIR/$base" rm -rf "$target" mkdir -p "$target" unzip -o "$src" -d "$target" DEPLOYED+=("$base") elif [ -d "$src" ]; then rm -rf "$DEST_DIR/$name" cp -r "$src" "$DEST_DIR/" DEPLOYED+=("$name") else cp "$src" "$DEST_DIR/" DEPLOYED+=("$name") fidone
if [ ${#DEPLOYED[@]} -eq 0 ]; then echo "Nothing deployed." exit 0fi
cd "$REPO_DIR"git add "$DEST_SUBDIR"
if git diff --cached --quiet; then echo "No changes to commit." exit 0fi
MSG="deploy: ${DEPLOYED[*]}"git commit -m "$MSG"git push origin "$BRANCH"
echo "==> Done: $MSG"インストール手順
# スクリプト配置ディレクトリを作成mkdir -p ~/bin
# エディタで新規作成して上記内容を貼り付けnano ~/bin/deploy-tool
# 実行権限付与chmod +x ~/bin/deploy-tool
# PATH に追加(初回のみ)echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc使用例
# フォルダを配置(推奨)deploy-tool sample-app
# zip を配置(自動解凍)deploy-tool sample-app.zip
# 単一ファイルdeploy-tool memo.html
# 複数まとめてdeploy-tool app-a app-b app-c.zip動作フロー
- 引数の名前を
SRC_DIRから解決 - リポジトリで
git pull --rebaseしてリモート最新を取り込む - 種別判定して配置:
.zip→DEST_DIR/<basename>/に展開(既存は削除して上書き)- ディレクトリ →
DEST_DIR/<name>/にコピー(既存は削除して上書き) - ファイル →
DEST_DIR/直下にコピー
git addしてステージ- 変更がなければ終了、あれば
deploy: <配置物一覧>としてコミット git push
競合が発生した場合の考え方
一人開発でも、複数端末間で作業すると競合は起こりうる。基本フロー:
- 作業前:
git pullで必ずリモートを取り込む - 作業後: ローカルをコミット → もう一度
pull --rebase→ 競合があれば解決 →push
「先に push してから pull」は不可。リモートに未取得のコミットがある状態で push は rejected される。必ず commit → pull → push の順。
本スクリプトは冒頭で pull --rebase を実行するため、通常のワンオペ運用では競合はほぼ発生しない。発生した場合は set -e により pull 段階で停止するので、手動で解決してから再実行する。
便利な補助設定
~/.bashrc に追記:
alias gs='git status'alias ga='git add .'alias gp='git push'alias gl='git pull'
alias cdrepo='cd ~/your-repo'反映:
source ~/.bashrc拡張の余地
現状のスクリプトはシンプルさを優先しているが、以下の拡張が考えられる:
- コミットメッセージをオプション引数化(
-m "custom message") - 配置先サブディレクトリの引数化(
-d docs/notes等) - ドライラン (
--dry-run) で配置予定のみ表示 - 削除操作のサポート(引数プレフィックス
-で削除など) - 複数リポジトリの切り替え(設定ファイル
~/.deploy-tool.conf)
必要になった段階で追加する。まずは最小構成で運用し、不足を実感してから拡張する方針。
まとめ
| 項目 | 結論 |
|---|---|
| Android から Git 運用する最適解 | Termux |
| github.dev の位置づけ | 軽い編集用のサブ手段 |
| PAT の管理 | 同一アカウント内で使い回し可、平文保存に注意 |
| リポジトリ実体の場所 | $HOME 配下(Termux 専用領域) |
| 素材受け渡し場所 | 共有ストレージの任意ディレクトリ |
| ワンコマンド化 | deploy-tool <name> で完結 |
| 競合対策 | pull --rebase を先頭に組み込み |
デスクトップに戻れない状況でも、モバイル端末単体で継続的にリポジトリを更新できる環境が整った。