AndroidブラウザからSpring Boot経由でアプリを起動する方法

はじめに (対象読者・この記事でわかること)

この記事は、Spring BootでWebアプリケーションを開発していて、Android端末のブラウザから自社のAndroidアプリを起動したいと考えている開発者を対象にしています。特に、Webとネイティブアプリの連携に興味がある方や、ディープリンクの実装に挑戦してみたい方におすすめです。

この記事を読むことで、Spring Bootで作成したWebページからAndroidアプリを起動する方法がわかります。カスタムURLスキームの設定方法、Intentフィルターの実装、そして実際にアプリを起動するまでの一連の流れをマスターできます。また、開発中に起こりがちなトラブルとその解決策も紹介します。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - JavaとSpring Bootの基本的な知識 - Androidアプリ開発の基礎知識 - HTMLとJavaScriptの基本的な理解

Webからアプリ起動の仕組みとメリット

WebブラウザからAndroidアプリを起動する技術は、ユーザーエクスペリエンスの向上に大きく貢献します。例えば、メールやSMSで送られたリンクをタップするだけで、自動的にアプリが開く仕組みは、多くのサービスで採用されている便利な機能です。

この仕組みを実現するには、主に2つの方法があります。一つは「カスタムURLスキーム」を使用する方法、もう一つは「Android App Links」を使用する方法です。本記事では、比較的簡単に実装できるカスタムURLスキームを使用した方法を詳しく解説します。

カスタムURLスキームを使用することで、myapp:// のような独自のプロトコルでアプリを起動できます。これにより、Webブラウザから直接アプリの特定の画面に遷移させることが可能になります。

Spring BootとAndroidアプリの連携実装

ここからは、実際にSpring Bootで作成したWebページからAndroidアプリを起動するまでの詳細な手順を解説します。

Android側の実装：Intentフィルターの設定

まず、Androidアプリ側でカスタムURLスキームを受け取れるように設定します。AndroidManifest.xmlファイルに以下のようにIntentフィルターを追加します。

Xml

<activity android:name=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <!-- カスタムURLスキーム用のIntentフィルター -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data 
            android:scheme="myapp"
            android:host="open"
            android:pathPrefix="/detail" />
    </intent-filter>
</activity>

この設定により、myapp://open/detailというURLがアプリに送信されたときに、MainActivityが起動するようになります。

次に、Activityで受け取ったIntentを処理するコードを実装します。

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Intentからデータを取得
    Intent intent = getIntent();
    Uri data = intent.getData();

    if (data != null) {
        String path = data.getPath();
        String query = data.getQuery();

        // URLパラメータに基づいて処理を分岐
        if ("/detail".equals(path)) {
            String itemId = data.getQueryParameter("id");
            if (itemId != null) {
                openDetailScreen(itemId);
            }
        }
    }
}

Spring Boot側の実装：Webページでのリンク生成

Spring Bootアプリケーションでは、Thymeleafテンプレートエンジンを使用して、カスタムURLスキームを含むリンクを生成します。

まず、Controllerクラスを作成します。

Java

@Controller
public class AppLaunchController {

    @GetMapping("/mobile")
    public String mobilePage(Model model) {
        // アプリがインストールされているかチェックするためのフラグ
        model.addAttribute("appInstalled", true);
        return "mobile";
    }
}

次に、Thymeleafテンプレート（mobile.html）を作成します。

Html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>アプリ起動ページ</title>
</head>
<body>
    <h1>アプリを起動</h1>

    <!-- アプリ起動リンク -->
    <a id="appLink" href="myapp://open/detail?id=12345">
        アプリで開く
    </a>

    <!-- アプリがインストールされていない場合の処理 -->
    <div id="fallback" style="display: none;">
        <p>アプリがインストールされていません。</p>
        <a href="https://play.google.com/store/apps/details?id=com.example.myapp">
            Google Playでダウンロード
        </a>
    </div>

    <script>
        // アプリ起動を試みる関数
        function tryLaunchApp() {
            const appLink = document.getElementById('appLink');
            const fallback = document.getElementById('fallback');

            // タイマーを設定して、指定時間内にアプリが起動しなければ
            // フォールバック（Playストア）を表示
            const timer = setTimeout(function() {
                appLink.style.display = 'none';
                fallback.style.display = 'block';
            }, 2000);

            // リンクをクリックしてアプリ起動を試みる
            window.location = appLink.href;

            // ページが表示されたらタイマーをクリア
            window.addEventListener('pageshow', function() {
                clearTimeout(timer);
            });
        }

        // ページ読み込み時に実行
        window.onload = function() {
            document.getElementById('appLink').onclick = function(e) {
                e.preventDefault();
                tryLaunchApp();
            };
        };
    </script>
</body>
</html>

ハマった点と解決策

実装中に遭遇した主な問題とその解決策を紹介します。

問題1：アプリが起動しない（ブラウザでエラーページが表示される）

この問題は、主にAndroid 6.0（APIレベル23）以降で発生します。セキュリティの強化により、カスタムURLスキームの処理が変更されたためです。

解決策： AndroidManifest.xmlでandroid:autoVerify="true"を設定し、デジタルアセットリンクを設定する必要があります。ただし、これは本記事では扱わない別の方法（Android App Links）になるため、カスタムURLスキームの場合は、JavaScriptでのフォールバック処理が重要になります。

問題2：パラメータが正しく渡らない

URLに含まれる特殊文字や日本語が正しく処理されない場合があります。

解決策： URLエンコーディングを適切に行います。Spring Boot側でパラメータを生成する際は、URLEncoderを使用してエンコードします。

Java

String param = URLEncoder.encode("パラメータ", "UTF-8");
String url = "myapp://open/detail?param=" + param;

問題3：異なるブラウザでの動作の違い

Chrome、Firefox、Safariなど、異なるブラウザで動作が異なる場合があります。

解決策： 各ブラウザに対応したJavaScriptを用意し、UserAgentで判別して処理を分岐させます。

Javascript

const userAgent = navigator.userAgent.toLowerCase();
if (userAgent.indexOf('chrome') > -1) {
    // Chrome用の処理
} else if (userAgent.indexOf('firefox') > -1) {
    // Firefox用の処理
}

まとめ

本記事では、Spring Bootで作成したWebページからAndroidアプリを起動する方法を解説しました。

カスタムURLスキームを使用したアプリ起動の仕組み
Intentフィルターの設定方法
Webページ側での実装とフォールバック処理
実装でよくある問題とその解決策

この記事を通して、Webとネイティブアプリの連携がスムーズに行えるようになりました。ユーザビリティの向上につながるこの技術は、ECサイトやメディアアプリ、様々なサービスで活用されています。

今後は、セキュリティが強化されたAndroid App Linksの実装方法や、iOS向けのUniversal Linksとの違いについても記事にする予定です。

AndroidブラウザからSpring Boot経由でアプリを起動する方法📱