Android 10 と XamarinAndroid 10 with Xamarin

Xamarin を使用して Android 10 用アプリの開発を開始する方法について説明します。How to get started developing apps for Android 10 using Xamarin.Android.

Android 10 を Google から入手できるようになりました。Android 10 is now available from Google. このリリースでは、多数の新機能と Api が提供されており、その多くは最新の Android デバイスで新しいハードウェア機能を利用するために必要です。A number of new features and APIs are being made available in this release, and many of them are necessary to take advantage of new hardware capabilities in the latest Android devices.

Android 10 のロゴ

この記事は、Android 10 用の Xamarin Android アプリの開発を開始する際に役立つように構成されています。This article is structured to help you get started in developing Xamarin.Android apps for Android 10. ここでは、必要な更新プログラムをインストールし、SDK を構成し、テスト用のエミュレーターまたはデバイスを準備する方法について説明します。It explains how to install the necessary updates, configure the SDK, and prepare an emulator or device for testing. また、Android 10 の新機能の概要を説明し、いくつかの主要な Android 10 機能の使用方法を示すソースコード例を示します。It also provides an outline of the new features in Android 10 and provides example source code that illustrates how to use some of the key Android 10 features.

Android 10.0 では、Android 10 がサポートされています。Xamarin.Android 10.0 provides support for Android 10. Android 10 向けの Xamarin のサポートの詳細については、「 Xamarin android 10.0 のリリースノート」を参照してください。For more information about Xamarin.Android support for Android 10, see the Xamarin.Android 10.0 release notes.

要件Requirements

Xamarin ベースのアプリで Android 10 の機能を使用するには、次の一覧が必要です。The following list is required to use Android 10 features in Xamarin-based apps:

  • Visual studio -visual studio 2019 をお勧めします。Visual Studio - Visual Studio 2019 is recommended. Windows update On Visual Studio 2019 バージョン16.3 以降。On Windows update to Visual Studio 2019 version 16.3 or later. MacOS で、Visual Studio 2019 for Mac バージョン8.3 以降に更新します。On macOS, update to Visual Studio 2019 for Mac version 8.3 or later.
  • Xamarin. android 10.0 以降を Visual Studio と共にインストールする必要があります (xamarin android は、Windows 上の .net ワークロードを使用したモバイル開発の一部として自動的にインストールされ、 Visual Studio for Mac インストーラーの一部としてインストールされます)Xamarin.Android - Xamarin.Android 10.0 or later must be installed with Visual Studio (Xamarin.Android is automatically installed as part of the Mobile Development With .NET workload on Windows and installed as part of the Visual Studio for Mac Installer)
  • Java Developer Kit -Xamarin Android 10.0 の開発には JDK 8 が必要です。Java Developer Kit - Xamarin.Android 10.0 development requires JDK 8. Microsoft の OpenJDK の配布は、Visual Studio の一部として自動的にインストールされます。Microsoft's distribution of the OpenJDK is automatically installed as part of Visual Studio.
  • Android SDK -Android SDK API 29 は Android SDK Manager を使用してインストールする必要があります。Android SDK - Android SDK API 29 must be installed via the Android SDK Manager.

作業開始Get started

Android 10 アプリの開発を Xamarin Android で開始するには、初めての Android 10 プロジェクトを作成する前に、最新のツールと SDK パッケージをダウンロードしてインストールする必要があります。To get started developing Android 10 apps with Xamarin.Android, you must download and install the latest tools and SDK packages before you can create your first Android 10 project:

  1. Visual Studio 2019 をお勧めします。Visual Studio 2019 is recommended. Visual Studio 2019 バージョン16.3 以降に更新します。Update to Visual Studio 2019 version 16.3 or later. Visual Studio for Mac 2019 を使用している場合は、Visual Studio 2019 for Mac バージョン8.3 以降に更新してください。If you are using Visual Studio for Mac 2019, update to Visual Studio 2019 for Mac version 8.3 or later.
  2. SDK Manager を使用して、 Android 10 (API 29) パッケージとツールをインストールします。Install Android 10 (API 29) packages and tools via the SDK Manager.
    • Android 10 (API 29) SDK プラットフォームAndroid 10 (API 29) SDK Platform
    • Android 10 (API 29) システムイメージAndroid 10 (API 29) System Image
    • Android SDK ビルドツール 29.0.0 +Android SDK Build-Tools 29.0.0+
    • Android SDK プラットフォーム-ツール 29.0.0 +Android SDK Platform-Tools 29.0.0+
    • Android Emulator 29.0.0 +Android Emulator 29.0.0+
  3. Android 10.0 を対象とする新しい Xamarin Android プロジェクトを作成します。Create a new Xamarin.Android project that targets Android 10.0.
  4. Android 10 アプリをテストするためのエミュレーターまたはデバイスを構成します。Configure an emulator or device for testing Android 10 apps.

これらの各手順を以下に説明します。Each of these steps is explained below:

Visual Studio を更新するUpdate Visual Studio

Xamarin を使用して Android 10 アプリをビルドする場合は、Visual Studio 2019 をお勧めします。Visual Studio 2019 is recommended for building Android 10 apps using Xamarin.

Visual studio 2019 を使用している場合は、Visual Studio 2019 バージョン16.3 以降に更新してください (手順については、「 Visual studio 2019 を最新のリリースに更新する」を参照してください)。If you are using Visual Studio 2019, update to Visual Studio 2019 version 16.3 or later (for instructions, see Update Visual Studio 2019 to the most recent release). MacOS で、Mac 8.3 以降の Visual Studio 2019 に更新します (手順については、「 Visual studio 2019 For mac を最新のリリースに更新する」を参照してください)。On macOS, update to Visual Studio 2019 for Mac 8.3 or later (for instructions, see Update Visual Studio 2019 for Mac to the most recent release).

Android SDK のインストールInstall the Android SDK

Xamarin Android 10.0 を使用してプロジェクトを作成するには、最初に Android SDK マネージャーを使用して Android 10 用の SDK プラットフォーム (API レベル 29) をインストールする必要があります。To create a project with Xamarin.Android 10.0, you must first use the Android SDK Manager to install the SDK platform for Android 10 (API level 29).

  1. SDK Manager を起動します。Start the SDK Manager. Visual Studio で、 [Tools > Android > Android SDK Manager] をクリックします。In Visual Studio, click Tools > Android > Android SDK Manager. Visual Studio for Mac で、 [ツール > SDK Manager] をクリックします。In Visual Studio for Mac, click Tools > SDK Manager.

  2. 右下隅にある歯車アイコンをクリックし、 [リポジトリ > Google (サポートされていません)] を選択します。In the lower right-hand corner, click the gear icon and select Repository > Google (Unsupported):

    Android SDK Manager リポジトリの選択

  3. [プラットフォーム] タブでAndroid SDK Platform 29と表示されているAndroid 10 SDK Platformパッケージをインストールします (sdk Manager の使用方法の詳細については、「 Android SDK セットアップ」を参照してください)。Install the Android 10 SDK Platform packages, which are listed as Android SDK Platform 29 in the Platforms tab (for more information about using the SDK Manager, see Android SDK setup):

    Android SDK Manager の [プラットフォーム] タブ

Xamarin Android プロジェクトを作成するCreate a Xamarin.Android project

新しい Xamarin. Android プロジェクトを作成します。Create a new Xamarin.Android project. Xamarin を使用した Android 開発を初めて使用する場合は、「 Hello, android 」を参照して、xamarin android プロジェクトの作成について学習してください。If you are new to Android development with Xamarin, see Hello, Android to learn about creating Xamarin.Android projects.

Android プロジェクトを作成するときは、バージョン設定を Android 10.0 以降を対象とするように構成する必要があります。When you create an Android project, you must configure the version settings to target Android 10.0 or later. たとえば、Android 10 のプロジェクトを対象にするには、プロジェクトのターゲットの Android API レベルをandroid 10.0 (API 29) に構成する必要があります。For example, to target your project for Android 10, you must configure the target Android API level of your project to Android 10.0 (API 29). これには、ターゲットフレームワークバージョンターゲット Android SDK バージョンの両方が API 29 以降に含まれます。This includes both your Target Framework Version and Target Android SDK Version to API 29 or later. Android API レベルの構成の詳細については、「 ANDROID Api レベルについて」を参照してください。For more information about configuring Android API levels, see Understanding Android API Levels.

Xamarin Android のターゲットフレームワーク

デバイスまたはエミュレーターを構成するConfigure a device or emulator

ピクセルなどの物理デバイスを使用している場合は、電話の設定で System > System update > Check for update に移動して、Android 10 の更新プログラムをダウンロードできます。If you are using a physical device such as a Pixel, you can download the Android 10 update by going to the System > System update > Check for update in your phone's settings. デバイスをフラッシュする場合は、デバイスへのファクトリイメージまたはOTA イメージのフラッシュに関する手順を参照してください。If you'd prefer to flash your device, please see the instructions on flashing a Factory Image or OTA Image to your device.

エミュレーターを使用している場合は、API レベル29用の仮想デバイスを作成し、x86 ベースのイメージを選択します。If you are using an emulator, create a virtual device for API level 29 and select an x86-based image. Android Device Manager を使用した仮想デバイスの作成と管理の詳細については、「 Android Device Manager を使用した仮想デバイスの管理」を参照してください。For information about using the Android Device Manager to create and manage virtual devices, see Managing Virtual Devices with the Android Device Manager. テストとデバッグに Android Emulator を使用する方法の詳細については、「 Android Emulator でのデバッグ」を参照してください。For information about using the Android Emulator for testing and debugging, see Debugging on the Android Emulator.

新機能New features

Android 10 では、さまざまな新機能が導入されています。Android 10 introduces a variety of new features. これらの新機能の一部は、最新の Android デバイスによって提供される新しいハードウェア機能を利用することを目的としていますが、Android ユーザーエクスペリエンスをさらに強化するように設計されています。Some of these new features are intended to leverage new hardware capabilities offered by the latest Android devices, while others are designed to further enhance the Android user experience:

Android 10 の機能と Api を使用してアプリを強化するEnhance your app with Android 10 features and APIs

次に、Android 10 について説明し、使用可能な 新しい機能と api  について説明します。Next, when you're ready, dive into Android 10 and learn about the new features and APIs that you can use. ここでは、基本的な機能をいくつか紹介します。Here are some of the top features to get started with.

すべてのアプリに対して、次の機能をお勧めします。These features are recommend for every app:

  • ダークテーマ:   ダークテーマ を追加するか、 強制濃色を有効にすることによって、システム全体のダークテーマを有効にするユーザーに一貫したエクスペリエンスを確保します。Dark Theme: Ensure a consistent experience for users who enable system-wide dark theme by adding a Dark Theme or enabling Force Dark.

ダーク テーマ

  • エッジツーエッジに移動し、カスタムジェスチャがシステムのナビゲーションジェスチャを補完するようにすることで、アプリの  gestural ナビゲーションをサポート します。Support gestural navigation in your app by going edge-to-edge and making sure your custom gestures are complementary to the system navigation gestures.

ジェスチャのナビゲーション

  • Optimize for foldables:   foldables 用に最適化することにより、現在の革新的なデバイス上でシームレスなエッジツーエッジのエクスペリエンスを実現します。Optimize for foldables: Deliver seamless, edge-to-edge experiences on today’s innovative devices by optimizing for foldables.

たたみ込み

アプリに関連する場合は、次の機能をお勧めします。These features are recommended if relevant for your app:

  • より対話的な通知:  通知にメッセージが含まれている場合は、 通知の返信とアクションを有効にし、ユーザーがすぐにアクションを実行できるように します。More interactive notifications: If your notifications include messages, enable suggested replies and actions in notifications to engage users and let them take action instantly.
  • 生体認証の向上:  生体認証を使用する場合は、最新のデバイスで指紋認証をサポートするための推奨される方法として、 BiometricPromptに移動します。Better biometrics: If you use biometric auth, move to BiometricPrompt, the preferred way to support fingerprint auth on modern devices.
  • 強化された記録: キャプションまたはゲームプレイの記録をサポートする 、 オーディオ再生のキャプチャを有効にします。Enriched recording: To support captioning or gameplay recording, enable audio playback capture. これは、より多くのユーザーにリーチし、アプリをより使いやすくするための優れた方法です。It’s a great way to reach more users and make your app more accessible.
  • より優れたコーデック:  メディアアプリの場合は、ビデオストリーミングには AV1 を、高ダイナミックレンジのビデオでは HDR10 + を試してください。Better codecs: For media apps, try AV1 for video streaming and HDR10+ for high dynamic range video. Speech および音楽ストリーミングの場合は、 Opusencoding を使用できます。また、ミュージシャンでは、 ネイティブ MIDI API が使用可能です。For speech and music streaming, you can use Opus encoding, and for musicians, a native MIDI API is available.
  • ネットワーク api の向上 : アプリが wi-fi 経由で IoT デバイスを管理している場合は、構成、ダウンロード、印刷などの機能に対して、新しい ネットワーク接続 api 試してみてください。Better networking APIs: If your app manages IoT devices over Wi-Fi, try the new network connection APIs for functions like configuring, downloading, or printing.

これらは、Android 10 の多くの新機能と Api のほんの一部です。These are just a few of the many new features and APIs in Android 10. すべてを表示するには、 開発者向けの Android 10 サイトにアクセスしてください。To see them all, visit the Android 10 site for developers.

動作の変更Behavior changes

ターゲットの Android バージョンが API レベル29に設定されている場合、上で説明した新機能を実装していない場合でも、アプリの動作に影響を与えるプラットフォームの変更がいくつかあります。When the Target Android Version is set to API level 29, there are several platform changes that cann affect your app's behavior even if you are not implementing the new features described above. これらの変更の簡単な概要を次に示します。The following list is a brief summary of these changes:

概要Summary

この記事では、Android 10 について紹介し、android 10 を使用した Xamarin Android 開発用の最新のツールとパッケージをインストールして構成する方法について説明しました。This article introduced Android 10 and explained how to install and configure the latest tools and packages for Xamarin.Android development with Android 10. Android 10 で使用できる主な機能の概要について説明しました。It provided an overview of the key features available in Android 10. Android 10 用のアプリの作成を開始する際に役立つ API ドキュメントと Android 開発者向けのトピックへのリンクが含まれています。It included links to API documentation and Android Developer topics to help you get started in creating apps for Android 10. また、既存のアプリに影響する可能性がある、最も重要な Android 10 の動作変更も強調表示されています。It also highlighted the most important Android 10 behavior changes that could impact existing apps.