💡 この記事について AIアシスタント（OpenClaw/スピカ）との会話を元にした学習記録です。 内容は変更される可能性があるため、実際の開発では公式ドキュメントを確認の上、ご自身の判断でお願いします。

🌟 Star Hopper とは？ スマホを夜空にかざすと「あの明るい星は何？」がわかる星座ナビアプリ。明るい星を手がかりに次の星座を見つけていく「スターホッピング」をガイドしてくれます。現在 Google Play でテスト中🚀

---

この記事で分かること：

• PWAからAndroidアプリ（Google Play配布）にする方法
• Capacitorの仕組みと選んだ理由
• Kotlinでネイティブセンサープラグインを自作する流れ
• ビルド時にハマった「JDKバージョン問題」と「署名の壁」

---

PWAじゃダメなの？問題

項目	PWA（ブラウザ）	ネイティブアプリ
コンパス精度	△ ブラウザ依存	◎ ハードウェア直接
カメラアクセス	○ 基本OK	◎ フル制御
重い処理	△ JSエンジン経由	◎ ネイティブ速度
ストア配布	× 不可	◎ Google Play
既存コードの活用	◎ そのまま	△ 書き直し？

---

React NativeでもFlutterでもない選択肢

🌐 既存のWebアプリ（HTML/CSS/JS）
     ↓ そのまま
📱 Android WebView にラッピング
     ↓ 必要な部分だけ
🔧 Kotlin/Swiftでネイティブ機能を追加

☝️ 実際のStar Hopper画面。北斗七星から北極星への道筋を、ステップバイステップでガイドしてくれる。こういうリアルタイムな方位連動が、ネイティブセンサーの恩恵。

# ① プロジェクトをCapacitor対応にする（設定ファイルが生成される）
npx cap init

# ② Androidプラットフォームを追加（androidフォルダが自動生成される）
npx cap add android

---

「南を向いたのに北って出る」事件 🧭

// ポートレート（縦持ち）用に座標系をリマップ
SensorManager.remapCoordinateSystem(
    rotationMatrix,
    SensorManager.AXIS_X,    // X軸はそのまま
    SensorManager.AXIS_Z,    // Y軸→Z軸に変換
    adjustedMatrix
)

☝️ 修正後の画面。ちゃんと「南 194°」と表示されている。たった3行の修正で、南北逆転が解消された。

---

JDKバージョン地獄

Unsupported class file major version 65

# JDKバージョン確認
java -version
# java version "21.0.x" が出ればOK

# JAVA_HOMEの設定（Mac）
export JAVA_HOME=$(/usr/libexec/java_home -v 21)

---

「署名」って何？キーストアの壁

# キーストア生成
keytool -genkeypair -v \
  -keystore starhopper-upload.jks \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -alias starhopper \
  -storepass [パスワード] \
  -keypass [パスワード] \
  -dname "CN=Star Hopper, OU=Development, O=7Sapiens, L=Tokyo, C=JP"

// android/app/build.gradle
android {
    signingConfigs {
        release {
            storeFile file('../starhopper-upload.jks')
            storePassword '[パスワード]'
            keyAlias 'starhopper'
            keyPassword '[パスワード]'
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

鍵の種類	誰が持つ？	役割
アプリ署名鍵	Google	ストアでの最終署名に使う。Googleが安全に保管
アップロード鍵	開発者（自分）	AABをアップロードする時の本人確認用

• iCloud Drive / Google Drive — 暗号化された場所にバックアップ
• USB経由でコピー — ネットワークを経由しない最安全
• 1Password / Bitwarden — パスワードマネージャーにファイルごと保存

# .gitignore に追加
*.jks
*.keystore

---

振り返り — 「PWA → Android」で見えた景色

✨ シリウスを見つけた時の達成画面。オリオンの三つ星からたどり着くルートをガイドして、最後にこの画面が出る。星の豆知識も読める。

1. 座標系リマップ — スマホの持ち方で座標軸が変わる（3日悩んだ）
2. JDK 21 必須 — Capacitor 6+ の暗黙の要件
3. キーストア管理 — なくしたら終わりの秘密鍵

---

⚠️ 注意 この記事はOpenClaw/AIアシスタントとの会話を元にした内容です。 実際の運用は自身で確認してください。 技術情報は変わる可能性があるので、公式ドキュメントの確認を推奨します。

---

シリーズ目次

1. VPSとMac Miniの違い
2. Groq APIで音声文字起こし
3. 喋るだけでブログ記事になる仕組み
4. PWAを”本物のアプリ”にしたい ← 今ここ
5. はじめてのGoogle Play — ストア掲載編（次回）