Desenvolvimento de plataforma cruzada com a biblioteca de classes portátilCross-platform development with the Portable Class Library

O tipo de projeto de biblioteca de classes portátil no Visual Studio ajuda a criar aplicativos de plataforma cruzada e bibliotecas para plataformas da Microsoft de forma rápida e fácil.The Portable Class Library project type in Visual Studio helps you build cross-platform apps and libraries for Microsoft platforms quickly and easily.

Importante

Porque os projetos de biblioteca de classes portátil destinam-se apenas um subconjunto muito específico de implementações do .NET, nós não recomendamos seu uso em desenvolvimento de novos aplicativos.Because Portable Class Library projects target only a very specific subset of .NET implementations, we strongly discourage their use in new application development. A substituição recomendada é uma biblioteca .NET Standard, que se destina a todas as implementações do .NET que dão suporte a uma versão específica do .NET Standard.The recommended replacement is a .NET Standard library, which targets all .NET implementations that support a specific version of the .NET Standard. Para obter mais informações, confira .NET Standard.For more information, see .NET Standard.

Bibliotecas de classes portáteis podem ajudar a reduzir o tempo e os custos com desenvolvimento e testes de código.Portable class libraries can help you reduce the time and costs of developing and testing code. Use esse tipo de projeto para gravar e compilar assemblies .NET Framework portáteis e, em seguida, referenciar os assemblies de aplicativos destinados a várias plataformas, como o .NET Framework, iOS ou Mac.Use this project type to write and build portable .NET Framework assemblies, and then reference those assemblies from apps that target multiple platforms such as the .NET Framework, iOS, or Mac.

Mesmo depois de criar um projeto de Biblioteca de Classes Portátil no Visual Studio e começar a desenvolvê-lo, é possível alterar as plataformas de destino.Even after you create a Portable Class Library project in Visual Studio and start developing it, you can change the target platforms. O Visual Studio compila sua biblioteca com os novos assemblies, que ajuda você a identificar as alterações que você precisa fazer em seu código.Visual Studio compiles your library with the new assemblies, which helps you identify the changes you need to make in your code.

Criar um projeto de biblioteca de classes portátilCreate a Portable Class Library project

Para criar uma biblioteca de classes portátil, use o modelo fornecido no Visual Studio.To create a Portable Class Library, use the template provided in Visual Studio. Criar um novo projeto (arquivo > novo projeto) e, no novo projeto caixa de diálogo, selecione a linguagem de programação (Visual c# ou Visual Basic).Create a new project (File > New Project), and in the New Project dialog box, select your programming language (Visual C# or Visual Basic). Em seguida, selecione a biblioteca de classes (portátil herdado) modelo.Then, select the Class Library (Legacy Portable) template. Insira um nome para seu projeto e escolha Okey.Enter a name for your project and choose OK.

O adicionar a biblioteca de classes portátil caixa de diálogo é exibida.The Add Portable Class Library dialog box appears. Escolha dois ou mais destinos e, em seguida, escolha Okey.Choose two or more targets, and then choose OK.

Adicionar destinos da biblioteca de classes portátil no Visual Studio

Alterar destinosChange targets

Quando você criá-lo ou depois de começar o desenvolvimento, você pode alterar as plataformas de destino de um projeto de biblioteca de classes portátil.You can change the target platforms of a portable class library project when you create it or after you’ve started development. Se você quiser alterar os destinos depois de criar seu projeto, no Gerenciador de soluções, abra o menu de atalho para o seu projeto de biblioteca de classes portátil (não na solução) e, em seguida, escolha propriedades .If you want to change the targets after you’ve created your project, in Solution Explorer, open the shortcut menu for your Portable Class Library project (not the solution), and then choose Properties. Na página de propriedades de projeto, o biblioteca guia mostra as plataformas que o projeto está destinado atualmente.On the project properties page, the Library tab shows the platforms that your project currently targets.

Propriedades do projeto de biblioteca de classes portátil no Visual Studio

Para adicionar ou remover destinos, escolha o alteração botão e, em seguida, selecione e desmarque as caixas de seleção apropriadas.To add or remove targets, choose the Change button, and then select and clear the appropriate check boxes.

Ao alterar os destinos, as APIs disponíveis para desenvolver o projeto mudarão conforme a sua seleção.When you change the targets, the APIs that are available to you for developing your project will change to match your selection. O Visual Studio relata os erros e avisos que podem ocorrer como resultado de alterações nos destinos.Visual Studio reports the errors and warnings that may occur as a result of the targets changing.

Se você quiser avaliar a portabilidade de seus assemblies antes de fazer alterações no Visual Studio, você pode usar o .NET Portability Analyzer.If you want to evaluate the portability of your assemblies before you make changes in Visual Studio, you can use the .NET Portability Analyzer.

Tipos e membros com suporteSupported types and members

Os tipos e membros disponíveis em projetos da Biblioteca de Classes Portátil são restritos por vários fatores de compatibilidade:The types and members that are available in Portable Class Library projects are constrained by several compatibility factors:

  • Eles devem ser compartilhados entre os destinos selecionados.They must be shared across the targets you selected.

  • Eles devem se comportar de forma semelhante nesses destinos.The must behave similarly across those targets.

  • Eles não devem ser candidatos à substituição.They must not be candidates for deprecation.

  • Eles devem fazer sentido em um ambiente portátil, especialmente quando os membros de suporte não são portáveis.They must make sense in a portable environment, especially when supporting members are not portable.

Se houver suporte a um membro na Biblioteca de Classes Portátil e aos destinos selecionados, isso aparecerá no projeto no IntelliSense.If a member is supported in the Portable Class Library and for your selected targets, it will appear in your project in IntelliSense. Porém, lembre-se de que uma API pode ter suporte na Biblioteca de Classes Portátil, mas sua capacidade de usá-la dependerá dos destinos selecionados.However, remember that an API may be supported in the Portable Class Library, but whether you can use the API depends on the targets you select.

Diferenças de API na Biblioteca de Classes PortátilAPI differences in the Portable Class Library

Para tornar os assemblies da Biblioteca de Classes Portátil compatíveis entre todas as plataformas com suporte, alguns membros foram ligeiramente alterados na Biblioteca de Classes Portátil.To make Portable Class Library assemblies compatible across all supported platforms, some members have been slightly changed in the Portable Class Library.

Use a biblioteca de classes portátilUse the Portable Class Library

Depois de criar o projeto da Biblioteca de Classes Portátil, você simplesmente faz uma referência a ele em outros projetos.After you build your Portable Class Library project, you just reference it from other projects. Você pode fazer referência ao projeto ou assemblies específicos que contêm as classes que deseja acessar.You can reference either the project or specific assemblies that contain the classes you want to access.

Para executar um aplicativo que faça referência a um assembly da Biblioteca de Classes Portátil, deve ser instalada a versão necessária (ou uma versão posterior) das plataformas de destino no computador.To run an app that references a Portable Class Library assembly, the required version (or later) of the targeted platforms must be installed on your computer. O Visual Studio contém todas as estruturas necessárias, assim, você pode executar aplicativos sem alteração adicional no computador usado para desenvolver o aplicativo.Visual Studio contains all the required frameworks, so you can run the app without further modification on the computer that you used to develop the app.

Implantar um aplicativo Windows UniversalDeploy a Universal Windows app

Quando você cria um aplicativo Windows Universal que referencia um assembly de biblioteca de classes portátil, tudo o que você precisa para implantar o aplicativo está incluído no pacote do aplicativo e nenhuma etapa adicional é necessária.When you create a Universal Windows app that references a Portable Class Library assembly, everything you need to deploy the app is included in the app package, and no further steps are required.

Implantar um .NET Framework de aplicativoDeploy a .NET Framework app

Ao implantar o aplicativo do .NET Framework que faça referência a um assembly da Biblioteca de Classes Portátil, você deve especificar uma dependência na versão correta do .NET Framework.When you deploy a .NET Framework app that references a Portable Class Library assembly, you must specify a dependency on the correct version of the .NET Framework. Ao especificar essa dependência, você garante que a versão requisitada seja instalada com seu aplicativo.By specifying this dependency, you ensure that the required version is installed with your app.

  • Para criar uma dependência com a implantação do ClickOnce: Na Gerenciador de soluções, escolha o nó do projeto para o projeto que você deseja publicar.To create a dependency with ClickOnce deployment: In Solution Explorer, choose the project node for the project you want to publish. (Esse projeto faz referência ao projeto da Biblioteca de Classes Portátil.) Na barra de menus, escolha Project > as propriedadese, em seguida, escolha o publicar guia. Sobre o Publish , escolha pré-requisitos.(This is the project that references the Portable Class Library project.) On the menu bar, choose Project > Properties, and then choose the Publish tab. On the Publish page, choose Prerequisites. Selecione a versão necessária do .NET Framework como um pré-requisito.Select the required .NET Framework version as a prerequisite.

  • Para criar uma dependência com um projeto de instalação: Na Gerenciador de soluções, escolha o projeto de instalação.To create a dependency with a setup project: In Solution Explorer, choose the setup project. Na barra de menus, escolha Project > as propriedades > pré-requisitos.On the menu bar, choose Project > Properties > Prerequisites. Selecione a versão necessária do .NET Framework como um pré-requisito.Select the required .NET Framework version as a prerequisite.

Para obter mais informações sobre como implantar aplicativos do .NET Framework, consulte guia de implantação para os desenvolvedores.For more information about deploying .NET Framework apps, see Deployment Guide for Developers.

Consulte tambémSee also