referencegrowing

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 版を使用する。

初期化コマンド

Terminal window
# パッケージ更新
pkg update -y && pkg upgrade -y
# 必要ツールを一括インストール
pkg install -y git openssh unzip nano
# Android 共有ストレージへのアクセス権を付与
termux-setup-storage

termux-setup-storage 実行時に権限ダイアログが出るので許可する。これで ~/storage/ 配下から共有ストレージにアクセスできるようになる。

GitHub 認証設定

Personal Access Token (PAT) を発行:

  1. GitHub にログイン
  2. Settings → Developer settings → Personal access tokens → Tokens (classic)
  3. Generate new token (classic)
  4. Scope で repo にチェック
  5. トークン文字列をコピー(表示は1回のみ)

Git 設定:

Terminal window
git config --global user.name "your-username"
git config --global user.email "[email protected]"
# 認証情報を保存(初回入力後は自動)
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 1
fi
if [ ! -d "$REPO_DIR/.git" ]; then
echo "Error: repository not found at $REPO_DIR"
exit 1
fi
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")
fi
done
if [ ${#DEPLOYED[@]} -eq 0 ]; then
echo "Nothing deployed."
exit 0
fi
cd "$REPO_DIR"
git add "$DEST_SUBDIR"
if git diff --cached --quiet; then
echo "No changes to commit."
exit 0
fi
MSG="deploy: ${DEPLOYED[*]}"
git commit -m "$MSG"
git push origin "$BRANCH"
echo "==> Done: $MSG"

インストール手順

Terminal window
# スクリプト配置ディレクトリを作成
mkdir -p ~/bin
# エディタで新規作成して上記内容を貼り付け
nano ~/bin/deploy-tool
# 実行権限付与
chmod +x ~/bin/deploy-tool
# PATH に追加(初回のみ)
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

使用例

Terminal window
# フォルダを配置(推奨)
deploy-tool sample-app
# zip を配置(自動解凍)
deploy-tool sample-app.zip
# 単一ファイル
deploy-tool memo.html
# 複数まとめて
deploy-tool app-a app-b app-c.zip

動作フロー

  1. 引数の名前を SRC_DIR から解決
  2. リポジトリで git pull --rebase してリモート最新を取り込む
  3. 種別判定して配置:
    • .zip → DEST_DIR/<basename>/ に展開(既存は削除して上書き)
    • ディレクトリ → DEST_DIR/<name>/ にコピー(既存は削除して上書き)
    • ファイル → DEST_DIR/ 直下にコピー
  4. git add してステージ
  5. 変更がなければ終了、あれば deploy: <配置物一覧> としてコミット
  6. git push

競合が発生した場合の考え方

一人開発でも、複数端末間で作業すると競合は起こりうる。基本フロー:

  1. 作業前: git pull で必ずリモートを取り込む
  2. 作業後: ローカルをコミット → もう一度 pull --rebase → 競合があれば解決 → push

「先に push してから pull」は不可。リモートに未取得のコミットがある状態で push は rejected される。必ず commit → pull → push の順。

本スクリプトは冒頭で pull --rebase を実行するため、通常のワンオペ運用では競合はほぼ発生しない。発生した場合は set -e により pull 段階で停止するので、手動で解決してから再実行する。


便利な補助設定

~/.bashrc に追記:

Terminal window
alias gs='git status'
alias ga='git add .'
alias gp='git push'
alias gl='git pull'
alias cdrepo='cd ~/your-repo'

反映:

Terminal window
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 を先頭に組み込み

デスクトップに戻れない状況でも、モバイル端末単体で継続的にリポジトリを更新できる環境が整った。