Exercício – criar seu primeiro aplicativo Xamarin.Forms

Concluído

Neste exercício, vamos criar nossa primeira solução do Xamarin.Forms. Vamos adicionar a essa solução posteriormente para criar nossa interface do usuário personalizada e adicionar funcionalidade.

Criar um projeto

Abra o Visual Studio e crie uma solução. Isso abre o assistente Novo Projeto no Visual Studio.

  1. No assistente Novo Projeto, pesquise "móvel" e selecione o modelo Aplicativo Móvel (Xamarin.Forms).

    Screenshot of Visual Studio Create a new project window, searching for

  2. Dê ao projeto o nome de Phoneword e selecione Criar para continuar.

  3. Selecione o Aplicativo em Branco para criar um aplicativo com interface do usuário mínima baseada em XAML.

  4. Selecione OK para criar a solução.

    Screenshot of Visual Studio New Cross Platform App window with the Blank template selected.

Examinar a estrutura da solução

Explore a solução do Xamarin.Forms para conhecer a finalidade de cada item dentro de um aplicativo Xamarin.Forms.

Screenshot of Visual Studio Solution Explorer, with several items labeled as described next.

  1. Nó da Solução – o código-fonte é organizado em apenas uma solução. Há vários projetos relacionados, incluindo um projeto compartilhado e um projeto para cada plataforma com suporte.

  2. Código Compartilhado – é a biblioteca de classes do .NET Standard. É referenciada por cada projeto específico da plataforma.

  3. Referências do NuGet e do .NET – é a lista de referências usadas pela biblioteca compartilhada. Observe que inclui um subconjunto das bibliotecas do .NET.

  4. Definição de aplicativo – novos projetos Xamarin.Forms incluem uma classe que deriva da classe Application. Essa classe é responsável por apresentar a interface do usuário. Quando você cria um projeto no Visual Studio, esse arquivo será chamado App.xaml.cs e aninhado sob App.xaml.

  5. Projetos Principais – são os projetos específicos da plataforma: um para cada plataforma para a qual estamos criando um aplicativo. Esses projetos criam os aplicativos reais que você implanta e cada um faz referência ao código compartilhado e ao pacote NuGet do Xamarin.Forms. Cada um deles chamará o próprio método Xamarin.Forms.Init para criar a tela inicial do aplicativo.

Abra o MainPage.xaml e altere "Bem-vindo(a) ao Xamarin.Forms!" para qualquer mensagem que desejar.

Selecione um projeto de inicialização

Selecione o projeto de plataforma que você deseja executar no Gerenciador de Soluções. Clique com o botão direito do mouse no nó do projeto e selecione Definir como Projeto de Inicialização. Lembre-se de que você não pode executar o projeto compilado compartilhado diretamente. Você deve escolher um dos projetos específicos da plataforma.

Dependendo de em qual plataforma você executa, o build restringirá os lugares em que você pode implantar. Por exemplo, projetos do iOS não poderão ser implantados em dispositivos Android e vice-versa. Além disso, a execução do projeto em um dispositivo ou simulador iOS exige que o desenvolvimento seja feito no Visual Studio para Mac diretamente ou através da conexão do Visual Studio a um dispositivo de compilação do macOS.

Executar o aplicativo

Execute o aplicativo em um dispositivo ou um simulador ou emulador selecionando o ícone de reprodução na barra de ferramentas.

Isso compila, implanta e executa o aplicativo no emulador ou dispositivo selecionado.

Ele deve exibir uma mensagem de boas-vindas ou seu texto personalizado, como mostrado aqui:

Screenshot of the FirstApp project running on the iOS Simulator.

Se tiver problemas para configurar um projeto como ativo ou se houver erros de implantação, verifique o tipo de build e a configuração da solução para ver quais projetos estão sendo criados.