JetBrains Rider 2020.1ヘルプ

Xamarin

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

Xamarinが依存する他のツール(Android SDK、Androidエミュレータなど)が正しく構成されていれば、XamarinアプリケーションをJetBrains Rider IDEから直接構築して実行することができます。

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は、たとえばVisual StudioのSDKなど、異なるXamarin 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 iOS開発用のXamarin SDKは、Windowsで制限された機能セットを提供します。例:現在、リモート Macに接続してフルビルド/デプロイを実行する(英語)サポートしていません。

    Windows上のAppleプラットフォーム用のJetBrains Xamarin SDKは、.zip ファイル(〜60Mb)として提供され、JetBrains MsBuildディレクトリにインストールされます。
    %LOCALAPPDATA%\JetBrains\BuildTools

  • Android

    Android開発用のJetBrains 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

    Android開発用のJetBrains 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 | Xamarin Mac エージェント)。

  1. 次のいずれかの方法で、Xamarin SDK for iOSをコンピューターにインストールします。

    • Visual StudioのXamarin(英語)をインストールします。Visual Studio Communityは無料で使用できます。Visual Studioが既にインストールされている場合は、Xamarinサポートを追加する(英語)必要があります。

    • JetBrains Rider設定 Ctrl+Alt+S環境ページでXamarin iOSおよびMacのインストールを開始し、インストールウィザードに従います。これにより、JetBrains RiderはiOSおよびMac用のJetBrains Xamarin SDKを自動的にダウンロードしてインストールします。

    • あるいは、GitHubからXamarinオープンソースリポジトリを複製し、それをビルドしてマシンにインストールすることもできます。この方法は非常に複雑で、お勧めしません。

  2. 次のいずれかの方法でAndroid開発ツールをインストールしてください。

    • JetBrains Rider設定 Ctrl+Alt+S環境ページでXamarin Androidのインストールを開始し、インストールウィザードに従います。これにより、JetBrains RiderはAndroid用のJetBrains Xamarin SDKを自動的にダウンロードしてインストールします。

    • あるいは、JetBrains Rider 環境設定ページに自動的に自動的にインストールされるすべてのコンポーネントを手動でインストールすることもできます。

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

  1. 次のいずれかの方法でXamarin SDKをあなたのマシンにインストールしてください。

    • Mac用Visual Studio(英語)をインストールします。

    • JetBrains Rider設定 Ctrl+Alt+S環境ページでXamarin iOSおよびMacのインストールを開始し、インストールウィザードに従います。これにより、JetBrains RiderはiOSおよびMac用のJetBrains Xamarin SDKを自動的にダウンロードしてインストールします。

    • あるいは、GitHubからXamarinオープンソースリポジトリを複製し、それをビルドしてマシンにインストールすることもできます。この方法は非常に複雑で、お勧めしません。

  2. iOSおよびMac開発の場合、Xcode(英語)をインストールします。XcodeをインストールしてサインインするにはApple IDが必要です。まだ持っていない場合は、https://appleid.apple.com(英語)で新しいものを作成できます。
    JetBrains RiderはXcodeを自動的に検出します。複数のXcodeバージョン(英語)がある場合、JetBrains Rider設定 Ctrl+Alt+Sビルド、実行、デプロイ | iOSページで使用するバージョン(英語)を選択できます。

  3. 次のいずれかの方法でAndroid開発ツールをインストールしてください。

    • JetBrains Rider設定 Ctrl+Alt+S環境ページでXamarin Androidのインストールを開始し、インストールウィザードに従います。これにより、JetBrains RiderはAndroid用のJetBrains Xamarin SDKを自動的にダウンロードしてインストールします。

    • あるいは、JetBrains Rider 環境設定ページに自動的に自動的にインストールされるすべてのコンポーネントを手動でインストールすることもできます。

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

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

JetBrains Rider: Environment settings

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プロジェクトに統合します。ユーザータイプの .designer.cs 部分( NSObjectから継承)を変更し、変更されたすべてのリソースをコピーバックします。

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

Xamarin development in JetBrains Rider: Xcode console

ボンネットでの仕組み

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

  1. JetBrains Riderは、対応する xcodeproj プロジェクト(pbxproj およびその他の必要なファイル)プロジェクトを、obj\xcode サブディレクトリにすべての必要な設定と構成で作成します。

  2. すべてのコンテンツファイル(ビュー、plistファイル、イメージなど)のコピーがそのディレクトリに作成されます。

  3. ViewController タイプごとに、JetBrains Riderはアクションとアウトレットを持つobjcクラスを生成します。

  4. 生成されたプロジェクトはXcodeで自動的に開かれます。

Xcodeを変更してからRiderに切り替えたとき

  1. 変更されたすべてのコンテンツファイルが.NETプロジェクトにコピーされます。

  2. 設定が更新されます。

  3. 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プロジェクトをデバッグする

  1. 設定/環境設定ダイアログ Ctrl+Alt+Sで、環境を選択します。

  2. Xamarin AndroidおよびXamarin iOSおよびMacサポートを有効にします。

    Windowsを使用していて、Xamarin SDKがVisual Studioを介してインストールされている場合、自動的に検出されます。それ以外の場合、JetBrains RiderはJetBrains Xamarin SDKのインストールを提案します。

  3. Xamarin SDKをインストールしたら、Xamarin固有の実行/デバッグ構成を作成できます。

  4. 以下のいずれかの方法で実行/デバッグ構成ダイアログを開きます。

    • メインメニューから実行 | 構成の編集を選択します。

    • ナビゲーション・バーが表示された状態(表示 | 外観 | ナビゲーション・バー)で、実行/デバッグ構成セレクターから構成の編集を選択します。

    • Ctrl+Shift+Alt+Rを押してから 0 を押すか、ポップアップから構成を選択して F4を押します。

  5. 開いた実行/デバッグ構成ダイアログで、Ctrl+N を押すか Addをクリックしてから、リストからXamarin.AndroidXamarin.iOS、またはXamarin.Macを選択します。

  6. 必要に応じてターゲットプロジェクトとその他のパラメーターを指定し、OKをクリックします。

  7. 新しく作成した構成を使用して、Xamarinプロジェクトを実行およびデバッグします。

ウェビナー録画: Mac用のRiderによるXamarin開発の改善

Dylan BerryがRiderを使用してXamarinアプリを開発する際のコーディングの速度と品質を向上させるさまざまな方法を探求する、このwebinarの記録も参照してください。

ウェビナーのアジェンダ:

最終更新日: 2020年7月2日

関連ページ:

コード解析

JetBrains Riderは、エディター内の単一のステートメントから、ソリューション全体のアーキテクチャまで、さまざまなレベルのコードを分析できます。コードの課題を見つける:JetBrains Riderは、C#、VB.NET、XAML、XML、ASP.NET、ASP.NET MVC、Razor...

バージョン管理

VCS 操作のポップアップ( または)を使用すると、VCS関連のコマンドをすばやく呼び出すことができます。ポップアップ内のアクションのリストは、現在有効になっているVCSによって異なります。VCSオペレーションポップアップコマンドのリストは設定可能です。設定/環境設定の外観および振る舞い | メニュ...

実行/デバッグ構成を操作する

実行/デバッグ構成とビルド構成を混同しないでください。JetBrains Riderでコードを実行またはデバッグするには、実行/デバッグ構成を使用できます。各実行/デバッグ構成は、名前付きの実行/デバッグ起動プロパティのセットを表します。JetBrains Riderを使用して実行、デバッグ、または...

実行/デバッグ構成の作成および編集

ナビゲーションバーが表示されると、使用可能な実行/デバッグ構成が実行エリアの実行/デバッグ構成セレクタに表示されます。JetBrains Riderは、実行/デバッグ構成を処理するためのツールとして実行/デバッグ構成ダイアログを提供します:設定プロファイルを作成するか、デフォルトの設定を変更します。...

ユーザー・インターフェース

JetBrains Riderでプロジェクトを開くと、デフォルトのユーザーインターフェースは次のようになります。プラグインのセットと構成設定によっては、IDEの外観と動作が異なる場合があります。エディター:フォーカス:エディターを使用して、ソースコード、リソース、逆コンパイルされたコードの読み取り、...