Přenosné knihovny tříd (PCL)

Klíčovou součástí vytváření multiplatformních aplikací je schopnost sdílet kód napříč různými projekty specifickými pro platformu. To je ale složité tím, že různé platformy často používají jinou podmnožinu knihovny základních tříd .NET (BCL), a proto jsou ve skutečnosti sestaveny do jiného profilu knihovny .NET Core. To znamená, že každá platforma může používat pouze knihovny tříd, které jsou cílem stejného profilu, aby se ukázalo, že pro každou platformu vyžadují samostatné projekty knihovny tříd.

Existují tři hlavní přístupy ke sdílení kódu, které řeší tento problém: projekty .NET Standard, projekty sdíleného assetu a projekty PCL (Portable Class Library).

• Projekty .NET Standard jsou upřednostňovaným přístupem ke sdílení kódu .NET, přečtěte si další informace o projektech .NET Standard a Xamarinu.
• Projekty sdílených prostředků používají jednu sadu souborů a nabízí rychlý a jednoduchý způsob sdílení kódu v rámci řešení a obecně používá direktivy podmíněné kompilace k určení cest kódu pro různé platformy, které ho budou používat (další informace najdete v článku Sdílené projekty).
• Projekty PCL cílí na specifické profily, které podporují známou sadu tříd/funkcí seznamu BCL. Nevýhodou pcL je ale to, že často vyžadují dodatečné architektonické úsilí k oddělení specifického kódu profilu do vlastních knihoven.

Tato stránka vysvětluje, jak vytvořit projekt PCL , který cílí na konkrétní profil, na který pak může odkazovat více projektů specifických pro platformu.

Co je přenosná knihovna tříd?

Při vytváření projektu aplikace nebo projektu knihovny je výsledná knihovna DLL omezena na práci na konkrétní platformě, pro kterou je vytvořena. To vám zabrání v zápisu sestavení pro aplikaci pro Windows a následné opětovné použití v Xamarin.iOS a Xamarin.Android.

Při vytváření knihovny přenosných tříd ale můžete zvolit kombinaci platforem, na kterých má váš kód běžet. Volby kompatibility, které provedete při vytváření přenosné knihovny tříd, se přeloží do identifikátoru profilu, který popisuje, které platformy knihovna podporuje.

V následující tabulce jsou uvedeny některé funkce, které se liší podle platformy .NET. Pokud chcete napsat sestavení PCL, které je zaručeno spuštění na konkrétních zařízeních nebo platformách, jednoduše zvolíte, která podpora se vyžaduje při vytváření projektu.

Sloupec Xamarin odráží skutečnost, že Xamarin.iOS a Xamarin.Android podporují všechny profily dodávané se sadou Visual Studio a dostupnost funkcí ve všech vytvořených knihovnách bude omezena pouze ostatními platformami, které se rozhodnete podporovat.

Patří sem profily, které jsou kombinací:

• .NET 4 nebo .NET 4.5
• Silverlight 5
• Windows Phone 8
• Aplikace pro UPW

Další informace o možnostech různých profilů najdete na webu Microsoftu a podívat se na souhrn profilu PCL jiného člena komunity, který obsahuje informace o podporovaném rozhraní a další poznámky.

Benefity

1. Centralizované sdílení kódu – psaní a testování kódu v jednom projektu, který může využívat jiné knihovny nebo aplikace.
2. Operace refaktoringu ovlivní veškerý kód načtený v řešení (přenosná knihovna tříd a projekty specifické pro platformu).
3. Projekt PCL lze snadno odkazovat na jiné projekty v řešení nebo je možné sdílet výstupní sestavení, aby ostatní mohli odkazovat na jejich řešení.

Nevýhody

1. Vzhledem k tomu, že stejná přenosná knihovna tříd je sdílena mezi více aplikacemi, nelze na knihovny specifické pro platformu odkazovat (např. Community.CsharpSqlite.WP7).
2. Podmnožina knihovny přenosných tříd nemusí obsahovat třídy, které by jinak byly k dispozici v MonoTouch i Mono pro Android (například DllImport nebo System.IO.File).

Do určité míry lze obě nevýhody obejít pomocí vzoru zprostředkovatele nebo injektáže závislostí k kódování skutečné implementace v projektech platformy proti rozhraní nebo základní třídě definované v knihovně přenosných tříd.

Tento diagram znázorňuje architekturu multiplatformní aplikace využívající knihovnu přenosných tříd ke sdílení kódu, ale také použití injektáže závislostí pro předávání funkcí závislých na platformě:

Příklad PCL

Ukázková aplikace TaskyPortable ukazuje, jak lze s Xamarinem použít přenosnou knihovnu tříd. Tady je několik snímků obrazovky s výslednými aplikacemi běžícími na iOSu a Androidu:

Sdílí řadu datových a logických tříd, které jsou čistě přenosný kód, a také ukazuje, jak začlenit požadavky specifické pro platformu pomocí injektáže závislostí pro implementaci databáze SQLite.

Struktura řešení je zobrazená níže (v Visual Studio pro Mac a sadě Visual Studio):

Vzhledem k tomu, že kód SQLite-NET obsahuje části specifické pro platformu (pro práci s implementacemi SQLite v každém jiném operačním systému) pro demonstrační účely, které byly refaktorovány do abstraktní třídy, které lze zkompilovat do knihovny přenosných tříd, a skutečný kód implementovaný jako podtřídy v projektech iOS a Android.

TaskyPortableLibrary

Přenosná knihovna tříd je omezená v funkcích .NET, které může podporovat. Protože je zkompilován tak, aby běžel na více platformách, nemůže využívat [DllImport] funkce, které se používají v SQLite-NET. Místo toho se SQLite-NET implementuje jako abstraktní třída a pak se odkazuje přes zbytek sdíleného kódu. Extrakce abstraktního rozhraní API je znázorněná níže:

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();

}

Zbývající část sdíleného kódu používá abstraktní třídu k "ukládání" a "načtení" objektů z databáze. V každé aplikaci, která používá tuto abstraktní třídu, musíme předat úplnou implementaci, která poskytuje skutečné databázové funkce.

TaskyAndroid a TaskyiOS

Projekty aplikací pro iOS a Android obsahují uživatelský rozhraní a jiný kód specifický pro platformu, který se používá k připojení sdíleného kódu v PCL.

Tyto projekty také obsahují implementaci abstraktního databázového rozhraní API, které funguje na této platformě. V iOSu a Androidu je databázový stroj Sqlite integrovaný do operačního systému, takže implementace může použít [DllImport] , jak je znázorněno, k zajištění konkrétní implementace připojení k databázi. Tady je ukázka kódu implementace specifického pro platformu:

[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);

Úplnou implementaci si můžete prohlédnout v ukázkovém kódu.

Shrnutí

Tento článek stručně probral výhody a nástrahy přenosných knihoven tříd, ukázal, jak vytvářet a využívat knihovny PCLS z Visual Studio pro Mac a sady Visual Studio; a nakonec představil kompletní ukázkovou aplikaci – TaskyPortable – která ukazuje PCL v akci.

Související odkazy

• Vytváření multiplatformních aplikací
• Portable Visual Basic
• Sdílené projekty
• Možnosti sdílení kódu
• Vývoj pro různé platformy pomocí rozhraní .NET Framework (Microsoft)