Introdução ao Xamarin.EssentialsGet Started with Xamarin.Essentials

O Xamarin.Essentials oferece uma API única entre plataformas que funciona com qualquer aplicativo iOS, Android ou UWP e que pode ser acessado no código compartilhado, independentemente da forma como a interface do usuário é criada.Xamarin.Essentials provides a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created.

Suporte de plataformaPlatform Support

O Xamarin.Essentials é compatível com os seguintes sistemas operacionais e plataformas:Xamarin.Essentials supports the following platforms and operating systems:

PlataformaPlatform VersãoVersion
AndroidAndroid 4.4 (API 19) ou superior4.4 (API 19) or higher
iOSiOS 10.0 ou superior10.0 or higher
UWPUWP 10.0.16299.0 ou superior10.0.16299.0 or higher

InstalaçãoInstallation

O Xamarin.Essentials está disponível como um pacote NuGet que pode ser adicionado a qualquer projeto, novo ou existente, através do Visual Studio.Xamarin.Essentials is available as a NuGet package that can be added to any existing or new project using Visual Studio.

  1. Faça o download e instale o Visual Studio com as Ferramentas do Visual Studio para Xamarin.Download and install Visual Studio with the Visual Studio tools for Xamarin.

  2. Abra um projeto existente ou crie um novo projeto usando o modelo Aplicativo em branco no C# do Visual Studio (Android, iPhone e iPad ou plataforma cruzada).Open an existing project, or create a new project using the Blank App template under Visual Studio C# (Android, iPhone & iPad, or Cross-Platform). Importante: Se adicionar a um projeto UWP, verifique se o Build 16299 ou superior está definido nas propriedades do projeto.Important: If adding to a UWP project ensure Build 16299 or higher is set in the project properties.

  3. Adicione o pacote NuGet do Xamarin.Essentials a cada projeto:Add the Xamarin.Essentials NuGet package to each project:

    No painel do Gerenciador de Soluções, clique com o botão direito do mouse no nome da solução e escolha Gerenciar pacotes NuGet.In the Solution Explorer panel, right click on the solution name and select Manage NuGet Packages. Pesquise Xamarin.Essentials e instale o pacote em TODOS os projetos, incluindo bibliotecas do Android, iOS, UWP e .NET Standard.Search for Xamarin.Essentials and install the package into ALL projects including Android, iOS, UWP, and .NET Standard libraries.

  4. Adicione uma referência ao Xamarin.Essentials na classe C# para fazer referência às APIs.Add a reference to Xamarin.Essentials in any C# class to reference the APIs.

    using Xamarin.Essentials;
    
  5. O Xamarin.Essentials requer uma configuração específica da plataforma:Xamarin.Essentials requires platform-specific setup:

    O Xamarin.Essentials é compatível com, no mínimo, a versão 4.4 do Android, correspondente ao nível da API 19, mas, para compilação, a versão de destino do Android deve ser 9.0, que corresponde ao nível da API 28.Xamarin.Essentials supports a minimum Android version of 4.4, corresponding to API level 19, but the target Android version for compiling must be 9.0, corresponding to API level 28. (No Visual Studio, essas duas versões são definidas na caixa de diálogo Propriedades do Projeto para projetos do Android, na guia Manifesto do Android. No Visual Studio para Mac, elas são definidas na caixa de diálogo Opções do Projeto para projetos do Android, na guia Aplicativo Android).(In Visual Studio, these two versions are set in the Project Properties dialog for the Android project, in the Android Manifest tab. In Visual Studio for Mac, they're set in the Project Options dialog for the Android project, in the Android Application tab.)

    O Xamarin.Essentials instala a versão 28.0.0.1 das bibliotecas Xamarin.Android.Support necessárias.Xamarin.Essentials installs version 28.0.0.1 of the Xamarin.Android.Support libraries that it requires. As outras bibliotecas Xamarin.Android.Support exigidas pelo aplicativo também devem ser atualizadas para a versão 28.0.0.1 usando o gerenciador de pacotes NuGet.Any other Xamarin.Android.Support libraries that your application requires should also be updated to version 28.0.0.1 using the NuGet package manager. Todas as bibliotecas Xamarin.Android.Support usadas pelo aplicativo devem ser as mesmas e devem ter, pelo menos, a versão 28.0.0.1.All Xamarin.Android.Support libraries used by your application should be the same, and should be at least version 28.0.0.1. Confira a página de solução de problemas se tiver problemas para adicionar o NuGet do Xamarin.Essentials ou para atualizar NuGets na sua solução.Refer to the troubleshooting page if you have issues adding the Xamarin.Essentials NuGet or updating NuGets in your solution.

    No MainLauncher do projeto do Android ou qualquer Activity que é iniciada, o Xamarin.Essentials deve ser inicializado no método OnCreate:In the Android project's MainLauncher or any Activity that is launched Xamarin.Essentials must be initialized in the OnCreate method:

    protected override void OnCreate(Bundle savedInstanceState) {
        //...
        base.OnCreate(savedInstanceState);
        Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
        //...
    

    Para lidar com permissões de tempo de execução no Android, o Xamarin.Essentials deve receber qualquer OnRequestPermissionsResult.To handle runtime permissions on Android, Xamarin.Essentials must receive any OnRequestPermissionsResult. Adicione o seguinte código a todas as classes Activity:Add the following code to all Activity classes:

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults)
    {
        Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    
        base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    }
    
  6. Siga os guias do Xamarin.Essentials que permitem copiar e colar os trechos de código para cada recurso.Follow the Xamarin.Essentials guides that enable you to copy and paste code snippets for each feature.

Xamarin.Essentials – APIs multiplataforma para aplicativos móveis (vídeo)Xamarin.Essentials - Cross-Platform APIs for Mobile Apps (video)

Outros recursosOther Resources

Recomendamos que os novos desenvolvedores do Xamarin confiram a Introdução ao desenvolvimento do Xamarin.We recommend developers new to Xamarin visit getting started with Xamarin development.

Visite o Repositório do GitHub do Xamarin.Essentials para ver o código-fonte atual, o que vem a seguir, colocar exemplos em prática e clonar o repositório.Visit the Xamarin.Essentials GitHub Repository to see the current source code, what is coming next, run samples, and clone the repository. Contribuições da comunidade são bem-vindas!Community contributions are welcome!

Navegue pela documentação da API de todos os recursos do Xamarin.Essentials.Browse through the API documentation for every feature of Xamarin.Essentials.