Node.js

モバイルアプリ環境のセットアップ

このパートでは、KotlinとJetpack Composeを使ってモダンなAndroidアプリを作成します。バックエンドはVonage Verifyと通信する。

アプリの流れの概要

アプリはこの流れに従う:

  1. ユーザーは電話番号を入力する。
  2. アプリは電話番号をバックエンド(POST /verification).
  3. Silent Authenticationが成功すると、ユーザが検証される。
  4. 失敗した場合(または利用できない場合)、ユーザーはSMSコードの入力を求められる。
  5. アプリはコードをバックエンド(POST /check-code).
  6. アプリは検証結果を表示する。

覚えておく:AndroidアプリはVonageの秘密を保存しません。バックエンドを呼び出すだけです。

Androidプロジェクトの作成

  1. Android Studioを開く。

  2. クリック 新規プロジェクト → 空の作曲アクティビティ.

  3. これらの設定を使用する:

    • 名前 Verify2FADemo
    • 言語: コトリン
    • 最小SDK: API 24 (Android 7.0)
  4. クリック 終了 を実行し、Gradleの同期が完了するのを待つ。

Androidの依存関係を設定する

オープン app/build.gradle.kts そして以下の依存関係を追加(または更新)する。

これは、初めてモバイルに接する読者のために明記しておく価値がある:

  • ライブラリを構成する:XMLレイアウトの代わりにKotlin関数でUIを構築する(定型文が少なく、チュートリアルでフォローしやすい)。

  • OkHttp:バックエンドと通信するための信頼できるHTTPクライアント。(Androidはデフォルトでは "素敵な "モダンなHTTPクライアントを出荷していません)。

  • グソン:Kotlin/Javaオブジェクト↔JSONを変換するので、あらゆる場所で手作業でJSON文字列を構築する必要がありません。

  • コルーチン:Androidアプリはメインスレッドをブロックしてはならない。コルーチンを使えば、バックグラウンドでネットワーキングを行い、安全にUIを更新できる。

ファイルを編集したら 今すぐ同期.

インターネット許可とローカルネットワーク

AndroidManifest.xmlこれを <manifest> タグを付けている:

これがないと、Androidは単にすべての発信ネットワークコールをブロックしてしまう。

プレーンな http://... (HTTPSではない)場合、ターゲットSDK/ネットワークのセキュリティ設定によっては、Androidがブロックする可能性があります。

ローカルの開発では、これを <application> タグを付けている:

バックエンドの設定を local.properties

Kotlinファイルに直接URLをハードコードすることは、壊れやすく安全ではない。
代わりに、バックエンドのURLを local.propertiesである:

  • gitにコミットされていない
  • 特定の環境
  • ローカル設定用に設計

開く(または作成する) local.properties をAndroidプロジェクトのルートに追加する:

次に、この値をAndroidアプリで利用できるようにする。 BuildConfig.

app/build.gradle.ktsと付け加えた:

そして再度Gradleを同期する。これで生成されます:

Kotlinのコードで安全に使用できる。