言語およびフレームワーク: Xamarin

JetBrains Rider は、Android と iOS の両方の Xamarin アプリケーションの作成と操作をサポートしています。現在、JetBrains Rider は Xamarin フォームのデザイナーまたはプレビューアーを提供していませんが、C#、VB.NET、その他の言語のコード分析、コーディング支援、およびデバッグ機能だけでなく、統合 IDE などの一般的な IDE 機能も利用できます。VCS クライアント。

Xamarin が依存する他のツール (Android SDK、Android エミュレーターなど) が適切に構成されている場合は、JetBrains Rider IDE から Xamarin アプリケーションを直接ビルド、実行、公開できます。

macOS では、JetBrains Rider は Xcode との同期を提供します。これは、リソースとターゲットを構成し、アプリケーションに署名するために必要なものです。

Xamarin SDK

Xamarin アプリケーションを開発するには、あなたのマシンに Xamarin SDK が必要です。iOS/Mac 用と Android 用の 2 つの異なる Xamarin SDK があります。

Xamarin SDK は 2 つの部分で構成されています。

ターゲットプラットフォーム用の .NET タイプのアセンブリ。例: ベース OSX NSObject を表す .NET タイプ。これらのアセンブリを使用して、IDE とコンパイラーはユーザーコードを解決およびビルドします。
.NET プロジェクトをネイティブアプリケーションに変換するツール。これは、エミュレーターまたは物理デバイスにデプロイして実行できます。例: これらのツールを使用して、Android 用の .apk パッケージが作成されます。

JetBrains Xamarin SDK

JetBrains Rider は、さまざまな Xamarin SDK を使用できます。たとえば、Visual Studio の SDK です。ただし、マシンに Visual Studio がない場合は、JetBrains Rider チームによって準備およびパックされた JetBrains Xamarin SDK を使用できます。

JetBrains Xamarin SDK は、いくつかの改善と追加コードが加えられた Xamarin GitHub ソースのカスタムビルドです。

現在、JetBrains Xamarin SDK は、Visual Studio Xamarin SDK と比較していくつかの機能が不足していますが、継続的な改善の過程にあります。

JetBrains Xamarin SDK は、Windows および macOS で利用可能です。

次のプラットフォームを対象とした Windows で利用可能な 2 つの JetBrains Xamarin SDK ビルドがあります。

アップルプラットフォーム (iOS、Mac、tvOS、watchOS)

JetBrains Xamarin SDK for iOS 開発は、Windows で限定された機能セットを提供します。例: 現在、リモート Mac に接続してフルビルド / デプロイを実行するはサポートされていません。

JetBrains Xamarin SDK for Apple プラットフォーム（Windows）は、.zip ファイル（〜 60Mb）として提供され、JetBrains MsBuild ディレクトリにインストールされます。

%LOCALAPPDATA%\JetBrains\BuildTools。

Android

JetBrains Android 開発用の Xamarin SDK は、確かな機能セットを提供します。ただし、高速デプロイは現在サポートされていません。

Windows 上の Android プラットフォーム用の JetBrains Xamarin SDK は、.zip ファイル（〜 700Mb）として提供され、JetBrains MsBuild ディレクトリにインストールされます。

%LOCALAPPDATA%\JetBrains\BuildTools

macOS では、次のプラットフォームを対象とした 2 つの JetBrains Xamarin SDK ビルドが利用できます。

アップルプラットフォーム (iOS、Mac、tvOS、watchOS)

macOS では、Apple プラットフォーム用の JetBrains Xamarin SDK は、Visual Studio SDK とほぼ同じ機能セットを提供し、すべての既知のシナリオがサポートされています。

macOS での iOS 開発用 JetBrains Xamarin SDK は、.dmg ファイル（〜 700Mb）として提供され、以下にインストールされます。

/Library/Frameworks/Xamarin.iOS.framework
/Library/Frameworks/Xamarin.Mac.framework
/Library/Frameworks/Mono.framework/External

Android

JetBrains Android 開発用の Xamarin SDK は、確かな機能セットを提供します。ただし、高速デプロイは現在サポートされていません。

macOS での Android 開発用の JetBrains Xamarin SDK は、.dmg ファイル（〜 700Mb）として提供され、以下にインストールされます。

/Library/Frameworks/Xamarin.Android.framework
/Library/Frameworks/Mono.framework/External

始める前に

Xamarin はさまざまなプラットフォーム上で実行されることを目的としているため、Xamarin の開発はアプリケーションを構築および実行するためのいくつかの異なるツールに依存しています。

Windows では、任意のプラットフォーム用の Xamarin アプリケーションを開発できますが、ローカルのビルドと実行 / デバッグは Android デバイスとエミュレーターに制限されています。

Visual Studio Xamarin SDK を使用すると、iOS および macOS でアプリケーションをビルドして実行できるようになります。これを行うには、ネットワーク上でアクセス可能な Mac エージェントを構成し、メインメニューからツール | iOS | リモート Mac エージェントを選択し、新しい接続を追加して接続をクリックします。

次のいずれかの方法で、Xamarin SDK for iOS をコンピューターにインストールします。
- Visual Studio の Xamarin をインストールします。無料の Visual Studio コミュニティを使用できることに注意してください。Visual Studio がすでにインストールされている場合は、Xamarin サポートを追加する必要があります。
- JetBrains Rider 設定 Ctrl+Alt+S の環境ページで Xamarin iOS および Mac のインストールを開始し、インストールウィザードに従います。これにより、JetBrains Rider は iOS および Mac 用の JetBrains Xamarin SDK を自動的にダウンロードしてインストールします。
- あるいは、GitHub から Xamarin オープンソースリポジトリをクローンし、ビルドしてマシンにインストールすることもできます。この方法は非常に複雑なので、お勧めしません。
次のいずれかの方法で Android 開発ツールをインストールしてください。
- JetBrains Rider 設定 Ctrl+Alt+S の環境ページで Xamarin Android のインストールを開始し、インストールウィザードに従います。これにより、JetBrains Rider は Android 用の JetBrains Xamarin SDK を自動的にダウンロードしてインストールします。
- または、JetBrains Rider 設定 Ctrl+Alt+S の環境ページに自動的にインストールされるすべてのコンポーネントを手動でインストールすることもできます。
  - Rider Xamarin Android サポートプラグイン(英語)。それは Android SDK マネージャーのようなすべての必要な機能を持っています。
  - Android SDK は、Google によって開発および提供されています。Visual Studio、Android Studio、Rider（Rider Xamarin Android サポートプラグインを使用）からインストールするか、コマンドラインツールのセットとしてダウンロードできます。
  - Java SE 開発キット (JDK)(英語)

macOS では、完全にクロスプラットフォームの Xamarin アプリケーションを開発、構築、実行することができます。

次のいずれかの方法で Xamarin SDK をあなたのマシンにインストールしてください。
- Mac 用 Visual Studio をインストールします。
- JetBrains Rider 設定 Ctrl+Alt+S の環境ページで Xamarin iOS および Mac のインストールを開始し、インストールウィザードに従います。これにより、JetBrains Rider は iOS および Mac 用の JetBrains Xamarin SDK を自動的にダウンロードしてインストールします。
- あるいは、GitHub から Xamarin オープンソースリポジトリをクローンし、ビルドしてマシンにインストールすることもできます。この方法は非常に複雑なので、お勧めしません。
iOS および Mac 開発の場合は、Xcode(英語) をインストールします。Xcode をインストールしてサインインするには、AppleID が必要です。まだお持ちでない場合は、https://appleid.apple.com(英語) で新しいものを作成できます。
JetBrains Rider は Xcode を自動的に検出します。複数の Xcode バージョン(英語)がある場合は、JetBrains Rider 設定 Ctrl+Alt+S のビルド、実行、デプロイ | Apple プラットフォームページで使用するバージョンを選択できます。
次のいずれかの方法で Android 開発ツールをインストールしてください。
- JetBrains Rider 設定 Ctrl+Alt+S の環境ページで Xamarin Android のインストールを開始し、インストールウィザードに従います。これにより、JetBrains Rider は Android 用の JetBrains Xamarin SDK を自動的にダウンロードしてインストールします。
- または、JetBrains Rider 設定 Ctrl+Alt+S の環境ページに自動的にインストールされるすべてのコンポーネントを手動でインストールすることもできます。
  - Rider Xamarin Android サポートプラグイン(英語)。それは Android SDK マネージャーのようなすべての必要な機能を持っています。
  - Android SDK は、Google によって開発および提供されています。Visual Studio、Android Studio、Rider（Rider Xamarin Android サポートプラグインを使用）からインストールするか、コマンドラインツールのセットとしてダウンロードできます。
  - Java SE 開発キット (JDK)(英語)

Linux 上の Xamarin はサポートされていません。

Xamarin ツールのステータスを確認し、JetBrains Rider 設定 Ctrl+Alt+S の環境ページでインストールまたは更新できます。

Xamarin プロジェクトを作成して開く

JetBrains Rider は、既存のプロジェクトを新規作成して作業することをサポートします。プロジェクトテンプレートも利用できます。

ファイル | 新規ソリューション…を使用して新しいソリューションで新しい Xamarin プロジェクトを作成するか、ソリューションエクスプローラーでソリューションまたはソリューションフォルダーノードを右クリックし、追加 | 新規プロジェクトを選択して既存のソリューションに新しい Xamarin プロジェクトを追加できます。

JetBrains Rider: New Solution wizard. Xamarin

macOS での Xcode 同期

macOS で Xamarin アプリケーションを開発する場合は、リソースファイル(英語)を編集し、Xcode を使用してリソースをコードに接続する(英語)ことをお勧めします。

.storyboard、.xib、.plist ファイルまたは Xamarin macios プロジェクトノードのコンテキストメニューを使用して、Xcode で開くことができます。

ファイルまたはプロジェクトが Xcode で一度も開かれたことがない場合は、JetBrains Rider は次のように Xcode プロジェクトを生成します。

xcodeproj プロジェクト仕様（csproj に似ているが Xcode 用のプロジェクト記述子）が生成される
Objective C で NSObject （フォーム、デリゲート、ビュー、コントロールなど）を継承したすべてのユーザタイプのソースファイルが生成されます
すべてのリソース（イメージ、デザイナーファイル）がコピーされます

プロジェクト構造の準備が整うと、Xcode が自動的に起動し、リソースの編集に使用できるようになります。Rider はフォーカスを受け取るたびに、変更 (既存のファイル、新しいファイル、削除されたファイルの編集) を探し、これらの変更を Xamarin .NET プロジェクトに統合します。ユーザータイプ (NSObject から継承) の .designer.cs 部分を変更し、変更されたすべてのリソースをコピーして戻します。

すべての Xcode 関連のイベントは、Xcode でリソースまたはプロジェクトを開くと表示される Xcode コンソールツールウィンドウに出力されます。

Xamarin development in JetBrains Rider: Xcode console

動作原理

新しい Xamarin macios プロジェクトを作成するとき

JetBrains Rider は、対応する xcodeproj プロジェクト（pbxproj およびその他の必要なファイル）プロジェクトを、obj\xcode サブディレクトリにすべての必要な設定と構成で作成します。
すべてのコンテンツファイル（ビュー、plist ファイル、イメージなど）のコピーがそのディレクトリに作成されます。
ViewController タイプごとに、JetBrains Rider はアクションとアウトレットを持つ objc クラスを生成します。
生成されたプロジェクトは Xcode で自動的に開かれます。

Xcode で変更を加えてから Rider に切り替えると

変更されたすべてのコンテンツファイルが .NET プロジェクトにコピーされます。
設定が更新されます。
objc ファイルが解析され、*.designer.cs ファイルが View Controller 用に再生成されます。これらすべてのファイルについて、生成されたヘッダーが表示されます。
// WARNING // // This file has been generated automatically by Rider IDE // to store outlets and actions made in Xcode. // If it is removed, they will be lost. // Manual changes to this file may not be handled correctly.

Xamarin アプリケーションの実行とデバッグ

Xamarin プロジェクトを作成または開くと、JetBrains Rider はソリューション内の Xamarin プロジェクトごとに実行 / デバッグ構成を自動的に作成します。

アプリケーションの起動および実行方法を調整したい場合は、新しい実行 / デバッグ構成を編集して作成できます。IDE から Xamarin アプリケーションを起動するときに、ツールバーの対応するセレクターを使用して、使用する構成を選択できます。

JetBrains Rider: Choosing a run/debug configuration for Xamarin application

JetBrains Rider で作成されなかった Xamarin プロジェクトをデバッグする

Ctrl+Alt+S を押して設定を開き、環境を選択します。
Xamarin Android および Xamarin iOS および Mac サポートを有効にします。
Windows を使用していて、Visual Studio を介して Xamarin SDK がインストールされている場合は、自動的に検出されます。それ以外の場合、JetBrains Rider は JetBrains Xamarin SDK のインストールを提案します。
JetBrains Xamarin SDK は、Visual Studio Xamarin SDK と一緒にインストールすることはできません。
Xamarin SDK をインストールすると、Xamarin 固有の実行 / デバッグ構成を作成できます。
以下のいずれかの方法で実行 / デバッグ構成ダイアログを開きます。
- メインメニューから実行 | 実行構成の編集を選択します。
- ナビゲーションバーが表示された状態（表示 | 外観 | ナビゲーションバー）で、実行 / デバッグ構成セレクターから実行構成の編集を選択します。
- Alt+Shift+F10 を押してから、0 を押します。
開いた実行 / デバッグ構成ダイアログで、Alt+Insert を押すかをクリックしてから、リストから Xamarin.Android、Xamarin.iOS、Xamarin.Mac を選択します。
必要に応じてターゲットプロジェクトとその他のパラメーターを指定し、OK をクリックします。
新しく作成した構成を使用して、Xamarin プロジェクトを実行およびデバッグします。