Visual Studio 2017 または 2019 での Xamarin 用パッケージの作成

[アーティクル]
08/10/2023

Xamarin 用パッケージには、実行時のオペレーティングシステムに応じて、iOS、Android、および Windows でネイティブ API を使用するコードが含まれます。これを行うのは簡単ですが、開発者が共通の API のセキュリティ、外部からのアクセスを通じて PCL または .NET Standard ライブラリからパッケージを使用できるようにすることをお勧めします。

このチュートリアルでは、Visual Studio 2017 または 2019 を使用して、iOS、Android、および Windows 上のモバイルプロジェクトで使用できるクロスプラットフォームの NuGet パッケージを作成します。

前提条件
プロジェクトの構造体および抽象化コードを作成する
プラットフォーム固有のコードを記述する
.nuspec ファイルを作成して更新する
コンポーネントをパッケージ化する
関連トピック

前提条件

ユニバーサル Windows プラットフォーム (UWP) および Xamarin を備えた Visual Studio 2017 または 2019。 visualstudio.com から無料の Community Edition をインストールします。もちろん、Professional Edition と Enterprise Edition も使用できます。 UWP および Xamarin ツールを含めるには、カスタムインストールを選択して、適切なオプションを確認します。
NuGet CLI。 nuget.org/downloads から最新バージョンの nuget.exe をダウンロードして、任意の場所に保存します。次に、その場所を PATH 環境変数に追加します (まだ存在していない場合)。

Note

nuget.exe はインストーラーではなく CLI ツール自体です。したがって、ブラウザーからダウンロードしたファイルは実行するのではなく、必ず保存してください。

プロジェクトの構造体および抽象化コードを作成する

Visual Studio 用の Cross-Platform .NET Standard Plugin Templates 拡張機能をダウンロードして実行します。これらのテンプレートを使用することで、このチュートリアルで必要なプロジェクトの構造体を簡単に作成できます。
Visual Studio 2017 で、新しい>ファイル > Projectを検索Pluginし、クロスプラットフォーム .NET 標準ライブラリプラグイン テンプレートを選択し、名前を LoggingLibrary に変更して、[OK] をクリックします。

Visual Studio 2019 の [新しい>ファイル>] Projectで、クロスプラットフォーム .NET 標準ライブラリプラグイン テンプレートを検索Pluginして選択し、[次へ] をクリックします。

名前を「LoggingLibrary」に変更し、[作成] をクリックします。

結果として得られるソリューションには、以下のようなさまざまなプラットフォーム固有のプロジェクトと共に、2 つの共有プロジェクトが含まれます。

ILoggingLibrary.shared.cs ファイルに含まれる ILoggingLibrary プロジェクトでは、コンポーネントのパブリックインターフェイス (API のアクセス領域) が定義されます。これは、ライブラリへのインターフェイスを定義する場所です。
もう 1 つの共有プロジェクトでは、CrossLoggingLibrary.shared.cs に、実行時に抽象インターフェイスのプラットフォーム固有の実装を検索するコードが含まれています。通常、このファイルを変更する必要はありません。
プラットフォーム固有のプロジェクト (たとえば LoggingLibrary.android.cs、それぞれ、それぞれの LoggingLibraryImplementation.cs (VS 2017) ファイルまたは LoggingLibrary.<PLATFORM>.cs (VS 2019) ファイル内のインターフェイスのネイティブ実装が含まれています。これは、ライブラリのコードをビルドする場所です。

既定では、ILoggingLibrary プロジェクトの ILoggingLibrary.shared.cs ファイルにはインターフェイスの定義が含まれますが、メソッドは含まれません。このチュートリアルでは、以下のように Log メソッドを追加します。

using System;
using System.Collections.Generic;
using System.Text;

namespace Plugin.LoggingLibrary
{
    /// <summary>
    /// Interface for LoggingLibrary
    /// </summary>
    public interface ILoggingLibrary
    {
        /// <summary>
        /// Log a message
        /// </summary>
        void Log(string text);
    }
}

プラットフォーム固有のコードを記述する

ILoggingLibrary インターフェイスとそのメソッドのプラットフォーム固有の実装を行うには、次の操作を実行します。

各プラットフォームプロジェクトの LoggingLibraryImplementation.cs (VS 2017) または LoggingLibrary.<PLATFORM>.cs (VS 2019) ファイルを開き、必要なコードを追加します。例 (Android プラットフォームプロジェクトを使用する場合):

using System;
using System.Collections.Generic;
using System.Text;

namespace Plugin.LoggingLibrary
{
    /// <summary>
    /// Implementation for Feature
    /// </summary>
    public class LoggingLibraryImplementation : ILoggingLibrary
    {
        /// <summary>
        /// Log a message
        /// </summary>
        public void Log(string text)
        {
            throw new NotImplementedException("Called Log on Android");
        }
    }
}

サポートする各プラットフォームのプロジェクトでこの実装を繰り返します。
ソリューションを右クリックし、[ソリューションのビルド] を選択して作業内容を確認し、次にパッケージ化する成果物を生成します。欠落している参照に関するエラーが発生した場合は、ソリューションを右クリックし、[NuGet パッケージの復元] を選択して依存関係をインストールしてからリビルドします。

Note

Visual Studio 2019 を使用している場合は、[NuGet パッケージの復元] を選択してリビルドしてみる前に、LoggingLibrary.csproj で MSBuild.Sdk.Extras のバージョンを 2.0.54 に変更する必要があります。このファイルにアクセスするには、まず (ソリューションの下の) プロジェクトを右クリックして [Unload Project] を選択した後、アンロードされたプロジェクトを右クリックして [Edit LoggingLibrary.csproj] を選択する必要があります。

注意

iOS 用にビルドするには、「Xamarin.iOS for Visual Studio の概要」の説明に従って、ネットワーク接続された Mac を Visual Studio に接続する必要があります。使用可能な Mac がない場合は、構成マネージャーで iOS プロジェクトをクリアします (上記の手順 3)。

.nuspec ファイルを作成して更新する

コマンドプロンプトを開き、.sln ファイルの 1 レベル下の LoggingLibrary フォルダーに移動して NuGet spec コマンドを実行し、初期 Package.nuspec ファイルを作成します。
```
nuget spec
```
このファイルの名前を LoggingLibrary.nuspec に変更して、エディターで開きます。

以下の内容と一致するようにファイルを更新して、YOUR_NAME を適切な値に置き換えます。具体的には、<id> 値を nuget.org で固有のものにする必要があります (「パッケージの作成」で説明されている名前付け規則に関する記述を参照)。また、作成者と説明のタグを更新する必要があることに注意してください。そうしないと、パッキングの手順でエラーが発生します。

<?xml version="1.0"?>
<package >
    <metadata>
    <id>LoggingLibrary.YOUR_NAME</id>
    <version>1.0.0</version>
    <title>LoggingLibrary</title>
    <authors>YOUR_NAME</authors>
    <owners>YOUR_NAME</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Awesome application logging utility</description>
    <releaseNotes>First release</releaseNotes>
    <copyright>Copyright 2018</copyright>
    <tags>logger logging logs</tags>
    </metadata>
</package>

ヒント

パッケージバージョンの末尾を -alpha、-beta または -rc にしてパッケージをプレリリースとしてマークすることができます。プレリリースバージョンの詳細については、プレリリースバージョンに関するページを確認してください。

参照アセンブリを追加する

プラットフォーム固有の参照アセンブリを含めるには、サポート対象プラットフォームに応じて、以下の内容を LoggingLibrary.nuspec の <files> 要素に追加します。

<!-- Insert below <metadata> element -->
<files>
    <!-- Cross-platform reference assemblies -->
    <file src="Plugin.LoggingLibrary\bin\Release\Plugin.LoggingLibrary.dll" target="lib\netstandard1.4\Plugin.LoggingLibrary.dll" />
    <file src="Plugin.LoggingLibrary\bin\Release\Plugin.LoggingLibrary.xml" target="lib\netstandard1.4\Plugin.LoggingLibrary.xml" />
    <file src="Plugin.LoggingLibrary.Abstractions\bin\Release\Plugin.LoggingLibrary.Abstractions.dll" target="lib\netstandard1.4\Plugin.LoggingLibrary.Abstractions.dll" />
    <file src="Plugin.LoggingLibrary.Abstractions\bin\Release\Plugin.LoggingLibrary.Abstractions.xml" target="lib\netstandard1.4\Plugin.LoggingLibrary.Abstractions.xml" />

    <!-- iOS reference assemblies -->
    <file src="Plugin.LoggingLibrary.iOS\bin\Release\Plugin.LoggingLibrary.dll" target="lib\Xamarin.iOS10\Plugin.LoggingLibrary.dll" />
    <file src="Plugin.LoggingLibrary.iOS\bin\Release\Plugin.LoggingLibrary.xml" target="lib\Xamarin.iOS10\Plugin.LoggingLibrary.xml" />

    <!-- Android reference assemblies -->
    <file src="Plugin.LoggingLibrary.Android\bin\Release\Plugin.LoggingLibrary.dll" target="lib\MonoAndroid10\Plugin.LoggingLibrary.dll" />
    <file src="Plugin.LoggingLibrary.Android\bin\Release\Plugin.LoggingLibrary.xml" target="lib\MonoAndroid10\Plugin.LoggingLibrary.xml" />

    <!-- UWP reference assemblies -->
    <file src="Plugin.LoggingLibrary.UWP\bin\Release\Plugin.LoggingLibrary.dll" target="lib\UAP10\Plugin.LoggingLibrary.dll" />
    <file src="Plugin.LoggingLibrary.UWP\bin\Release\Plugin.LoggingLibrary.xml" target="lib\UAP10\Plugin.LoggingLibrary.xml" />
</files>

注意

DLL および XML ファイルの名前を短くするには、指定されたプロジェクトを右クリックし、[ライブラリ] タブを選択してアセンブリ名を変更します。

依存関係を追加する

ネイティブ実装の特定の依存関係がある場合は、次の例のように <dependencies> 要素と <group> 要素を使用して指定します。

<!-- Insert within the <metadata> element -->
<dependencies>
    <group targetFramework="MonoAndroid">
        <!--MonoAndroid dependencies go here-->
    </group>
    <group targetFramework="Xamarin.iOS10">
        <!--Xamarin.iOS10 dependencies go here-->
    </group>
    <group targetFramework="uap">
        <!--uap dependencies go here-->
    </group>
</dependencies>

たとえば、以下の場合は、UAP ターゲットの依存関係として iTextSharp を設定します。

<dependencies>
    <group targetFramework="uap">
        <dependency id="iTextSharp" version="5.5.9" />
    </group>
</dependencies>

最終的な .nuspec

最終的な .nuspec ファイルは次のようになります。ここでも、YOUR_NAME は適切な値に置き換える必要があります。

<?xml version="1.0"?>
<package >
    <metadata>
    <id>LoggingLibrary.YOUR_NAME</id>
    <version>1.0.0</version>
    <title>LoggingLibrary</title>
    <authors>YOUR_NAME</authors>
    <owners>YOUR_NAME</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Awesome application logging utility</description>
    <releaseNotes>First release</releaseNotes>
    <copyright>Copyright 2018</copyright>
    <tags>logger logging logs</tags>
        <dependencies>
        <group targetFramework="MonoAndroid">
            <!--MonoAndroid dependencies go here-->
        </group>
        <group targetFramework="Xamarin.iOS10">
            <!--Xamarin.iOS10 dependencies go here-->
        </group>
        <group targetFramework="uap">
            <dependency id="iTextSharp" version="5.5.9" />
        </group>
    </dependencies>
    </metadata>
    <files>
        <!-- Cross-platform reference assemblies -->
        <file src="Plugin.LoggingLibrary\bin\Release\Plugin.LoggingLibrary.dll" target="lib\netstandard1.4\Plugin.LoggingLibrary.dll" />
        <file src="Plugin.LoggingLibrary\bin\Release\Plugin.LoggingLibrary.xml" target="lib\netstandard1.4\Plugin.LoggingLibrary.xml" />
        <file src="Plugin.LoggingLibrary.Abstractions\bin\Release\Plugin.LoggingLibrary.Abstractions.dll" target="lib\netstandard1.4\Plugin.LoggingLibrary.Abstractions.dll" />
        <file src="Plugin.LoggingLibrary.Abstractions\bin\Release\Plugin.LoggingLibrary.Abstractions.xml" target="lib\netstandard1.4\Plugin.LoggingLibrary.Abstractions.xml" />

        <!-- iOS reference assemblies -->
        <file src="Plugin.LoggingLibrary.iOS\bin\Release\Plugin.LoggingLibrary.dll" target="lib\Xamarin.iOS10\Plugin.LoggingLibrary.dll" />
        <file src="Plugin.LoggingLibrary.iOS\bin\Release\Plugin.LoggingLibrary.xml" target="lib\Xamarin.iOS10\Plugin.LoggingLibrary.xml" />

        <!-- Android reference assemblies -->
        <file src="Plugin.LoggingLibrary.Android\bin\Release\Plugin.LoggingLibrary.dll" target="lib\MonoAndroid10\Plugin.LoggingLibrary.dll" />
        <file src="Plugin.LoggingLibrary.Android\bin\Release\Plugin.LoggingLibrary.xml" target="lib\MonoAndroid10\Plugin.LoggingLibrary.xml" />

        <!-- UWP reference assemblies -->
        <file src="Plugin.LoggingLibrary.UWP\bin\Release\Plugin.LoggingLibrary.dll" target="lib\UAP10\Plugin.LoggingLibrary.dll" />
        <file src="Plugin.LoggingLibrary.UWP\bin\Release\Plugin.LoggingLibrary.xml" target="lib\UAP10\Plugin.LoggingLibrary.xml" />
    </files>
</package>

コンポーネントをパッケージ化する

パッケージに含める必要があるすべてのファイルを参照する .nuspec が完成したら、以下の pack コマンドを実行できます。

nuget pack LoggingLibrary.nuspec

これにより、LoggingLibrary.YOUR_NAME.1.0.0.nupkg が生成されます。 NuGet パッケージエクスプローラーなどのツールでこのファイルを開き、すべてのノードを展開すると、以下のコンテンツが表示されます。

NuGet Package Explorer showing the LoggingLibrary package

ヒント

.nupkg ファイルは、異なる拡張子が付いた単なる .zip ファイルです。したがって、.nupkg を .zip に変えてパッケージの内容を調べることもできますが、パッケージを nuget.org にアップロードする前に必ず、拡張子を復元してください。

他の開発者がパッケージを使用できるようにするには、「パッケージの発行」の手順に従います。

次の方法で共有

Visual Studio 2017 または 2019 での Xamarin 用パッケージの作成

前提条件

プロジェクトの構造体および抽象化コードを作成する

プラットフォーム固有のコードを記述する

.nuspec ファイルを作成して更新する

参照アセンブリを追加する

依存関係を追加する

最終的な .nuspec

コンポーネントをパッケージ化する

フィードバック

その他のリソース

次の方法で共有

Visual Studio 2017 または 2019 での Xamarin 用パッケージの作成

前提条件

プロジェクトの構造体および抽象化コードを作成する

プラットフォーム固有のコードを記述する

.nuspec ファイルを作成して更新する

参照アセンブリを追加する

依存関係を追加する

最終的な .nuspec

コンポーネントをパッケージ化する

関連トピック

フィードバック

その他のリソース