PCL(이식 가능한 클래스 라이브러리)

플랫폼 간 애플리케이션을 빌드하는 핵심 구성 요소는 다양한 플랫폼별 프로젝트에서 코드를 공유할 수 있다는 것입니다. 그러나 다른 플랫폼이 종종 다른 BCL(기본 클래스 라이브러리) 하위 집합을 사용하므로 실제로 다른 .NET Core 라이브러리 프로필에 빌드되므로 이 문제는 복잡합니다. 즉, 각 플랫폼은 동일한 프로필을 대상으로 하는 클래스 라이브러리만 사용할 수 있으므로 각 플랫폼에 대해 별도의 클래스 라이브러리 프로젝트가 필요한 것처럼 보입니다.

이 문제를 해결하는 코드 공유에는 .NET Standard 프로젝트, 공유 자산 프로젝트 및 PCL(이식 가능한 클래스 라이브러리) 프로젝트의 세 가지 주요 방법이 있습니다.

• .NET Standard 프로젝트는 .NET 코드를 공유하기 위한 기본 방법입니다. .NET Standard 프로젝트 및 Xamarin에 대해 자세히 알아보세요.
• 공유 자산 프로젝트는 단일 파일 집합을 사용하며 솔루션 내에서 코드를 공유하는 빠르고 간단한 방법을 제공하며 일반적으로 조건부 컴파일 지시문을 사용하여 사용할 다양한 플랫폼에 대한 코드 경로를 지정합니다(자세한 내용은 공유 프로젝트 문서 참조).
• PCL 프로젝트는 알려진 BCL 클래스/기능 집합을 지원하는 특정 프로필을 대상으로 합니다. 그러나 PCL의 단점은 프로필 특정 코드를 자체 라이브러리로 분리하기 위해 추가적인 아키텍처 노력이 필요하다는 것입니다.

이 페이지에서는 특정 프로필을 대상으로 하는 PCL 프로젝트를 만든 다음, 여러 플랫폼별 프로젝트에서 참조할 수 있는 방법을 설명합니다.

이식 가능한 클래스 라이브러리란?

애플리케이션 프로젝트 또는 라이브러리 프로젝트를 만들 때 결과 DLL은 생성되는 특정 플랫폼에서 작업하도록 제한됩니다. 이렇게 하면 Windows 앱에 대한 어셈블리를 작성한 다음 Xamarin.iOS 및 Xamarin.Android에서 다시 사용할 수 없습니다.

그러나 이식 가능한 클래스 라이브러리를 만들 때 코드를 실행할 플랫폼 조합을 선택할 수 있습니다. 이식 가능한 클래스 라이브러리를 만들 때 선택하는 호환성은 라이브러리가 지원하는 플랫폼을 설명하는 "프로필" 식별자로 변환됩니다.

아래 표에서는 .NET 플랫폼에 따라 달라지는 몇 가지 기능을 보여줍니다. 특정 디바이스/플랫폼에서 실행되도록 보장되는 PCL 어셈블리를 작성하려면 프로젝트를 만들 때 필요한 지원을 선택하기만 하면 됩니다.

Xamarin 열은 Xamarin.iOS 및 Xamarin.Android가 Visual Studio와 함께 제공되는 모든 프로필을 지원한다는 사실을 반영하며, 사용자가 만든 라이브러리의 기능 가용성은 지원하도록 선택한 다른 플랫폼에 의해서만 제한됩니다.

여기에는 다음의 조합인 프로필이 포함됩니다.

• .NET 4 또는 .NET 4.5
• Silverlight 5
• Windows Phone 8
• UWP 앱

Microsoft 웹 사이트에서 다양한 프로필의 기능에 대해 자세히 알아보고 지원되는 프레임워크 정보 및 기타 메모를 포함하는 다른 커뮤니티 멤버의 PCL 프로필 요약을 볼 수 있습니다.

혜택

1. 중앙 집중식 코드 공유 – 다른 라이브러리 또는 애플리케이션에서 사용할 수 있는 단일 프로젝트에서 코드를 작성하고 테스트합니다.
2. 리팩터링 작업은 솔루션에 로드된 모든 코드(이식 가능한 클래스 라이브러리 및 플랫폼별 프로젝트)에 영향을 줍니다.
3. PCL 프로젝트를 솔루션의 다른 프로젝트에서 쉽게 참조하거나 다른 사용자가 솔루션에서 참조할 수 있도록 출력 어셈블리를 공유할 수 있습니다.

단점

1. 동일한 이식 가능한 클래스 라이브러리가 여러 애플리케이션 간에 공유되므로 플랫폼별 라이브러리를 참조할 수 없습니다(예: Community.CsharpSqlite.WP7).
2. 이식 가능한 클래스 라이브러리 하위 집합에는 Android용 MonoTouch 및 Mono(예: DllImport 또는 System.IO.File)에서 사용할 수 있는 클래스가 포함되지 않을 수 있습니다.

어느 정도는 공급자 패턴 또는 종속성 주입을 사용하여 이식 가능한 클래스 라이브러리에 정의된 인터페이스 또는 기본 클래스에 대해 플랫폼 프로젝트의 실제 구현을 코딩하는 두 가지 단점을 피할 수 있습니다.

이 다이어그램은 이식 가능한 클래스 라이브러리를 사용하여 코드를 공유하는 플랫폼 간 애플리케이션의 아키텍처를 보여 주지만 종속성 주입을 사용하여 플랫폼 종속 기능을 전달합니다.

PCL 예제

TaskyPortable 샘플 애플리케이션은 이식 가능한 클래스 라이브러리를 Xamarin과 함께 사용하는 방법을 보여 줍니다. iOS 및 Android에서 실행되는 결과 앱의 몇 가지 스크린샷은 다음과 같습니다.

순수하게 이식 가능한 코드인 여러 데이터 및 논리 클래스를 공유하며 SQLite 데이터베이스 구현에 종속성 주입을 사용하여 플랫폼별 요구 사항을 통합하는 방법도 보여 줍니다.

솔루션 구조는 아래와 같습니다(각각 Mac용 Visual Studio 및 Visual Studio에서).

SQLite-NET 코드에는 데모용으로 플랫폼별 조각(각 운영 체제의 SQLite 구현과 함께 작동)이 있으므로 이식 가능한 클래스 라이브러리로 컴파일할 수 있는 추상 클래스 및 iOS 및 Android 프로젝트에서 하위 클래스로 구현된 실제 코드로 리팩터링되었습니다.

TaskyPortableLibrary

이식 가능한 클래스 라이브러리는 지원할 수 있는 .NET 기능으로 제한됩니다. 여러 플랫폼에서 실행되도록 컴파일되므로 SQLite-NET에서 사용되는 기능을 사용할 [DllImport] 수 없습니다. 대신 SQLite-NET은 추상 클래스로 구현된 다음 나머지 공유 코드를 통해 참조됩니다. 추상 API의 추출은 다음과 같습니다.

public abstract class SQLiteConnection : IDisposable {

    public string DatabasePath { get; private set; }
    public bool TimeExecution { get; set; }
    public bool Trace { get; set; }
    public SQLiteConnection(string databasePath) {
         DatabasePath = databasePath;
    }
    public abstract int CreateTable<T>();
    public abstract SQLiteCommand CreateCommand(string cmdText, params object[] ps);
    public abstract int Execute(string query, params object[] args);
    public abstract List<T> Query<T>(string query, params object[] args) where T : new();
    public abstract TableQuery<T> Table<T>() where T : new();
    public abstract T Get<T>(object pk) where T : new();
    public bool IsInTransaction { get; protected set; }
    public abstract void BeginTransaction();
    public abstract void Rollback();
    public abstract void Commit();
    public abstract void RunInTransaction(Action action);
    public abstract int Insert(object obj);
    public abstract int Update(object obj);
    public abstract int Delete<T>(T obj);

    public void Dispose()
    {
        Close();
    }
    public abstract void Close();

}

공유 코드의 re기본der는 추상 클래스를 사용하여 데이터베이스에서 개체를 "저장"하고 "검색"합니다. 이 추상 클래스를 사용하는 모든 애플리케이션에서는 실제 데이터베이스 기능을 제공하는 완전한 구현을 전달해야 합니다.

TaskyAndroid 및 TaskyiOS

iOS 및 Android 애플리케이션 프로젝트에는 PCL에서 공유 코드를 연결하는 데 사용되는 사용자 인터페이스 및 기타 플랫폼별 코드가 포함되어 있습니다.

이러한 프로젝트에는 해당 플랫폼에서 작동하는 추상 데이터베이스 API의 구현도 포함됩니다. iOS 및 Android에서 Sqlite 데이터베이스 엔진은 운영 체제에 기본 제공되므로 구현은 표시된 대로 데이터베이스 연결의 구체적인 구현을 제공하는 데 사용할 [DllImport] 수 있습니다. 플랫폼별 구현 코드의 발췌 내용은 다음과 같습니다.

[DllImport("sqlite3", EntryPoint = "sqlite3_open")]
public static extern Result Open(string filename, out IntPtr db);

[DllImport("sqlite3", EntryPoint = "sqlite3_close")]
public static extern Result Close(IntPtr db);

전체 구현은 샘플 코드에서 볼 수 있습니다.

요약

이 문서에서는 이식 가능한 클래스 라이브러리의 이점과 단점에 대해 간략하게 설명하고, Mac용 Visual Studio 및 Visual Studio 내부에서 PCL을 만들고 사용하는 방법을 설명했으며, 마지막으로 PCL이 작동하는 전체 샘플 애플리케이션인 TaskyPortable을 소개했습니다.

관련 링크

• 플랫폼 간 애플리케이션 빌드
• 이식 가능한 Visual Basic
• 공유 프로젝트
• 코드 공유 옵션
• .NET Framework를 사용한 플랫폼 간 개발(Microsoft)