Partilhar via


Início rápido: Criar um projeto Python a partir de um template no Visual Studio

Neste quickstart, segue passos guiados para criar rapidamente uma aplicação Flask usando um modelo de projeto Python incorporado. O Visual Studio facilita o desenvolvimento de projetos Python com código padrão e funcionalidades em templates para vários frameworks Python, incluindo Flask, Django e Bottle. O projeto Python descrito neste artigo é semelhante ao projeto que cria manualmente através do artigo Quickstart: Criar uma aplicação web com Flask .

Pré-requisitos

  • Visual Studio instalado com suporte para cargas de trabalho em Python.

    No Visual Studio Installer, selecione a carga de trabalho de desenvolvimento em Python e a opção de suporte web em Python para aceder a modelos de projetos web. Para obter mais informações, consulte Instalar suporte a Python no Visual Studio.

    Captura de ecrã que mostra como selecionar suporte web para Python no Visual Studio Installer para a carga de trabalho de desenvolvimento Python.

O Visual Studio para Mac não é suportado. O Visual Studio Code no Windows, Mac e Linux funciona bem com Python através das extensões disponíveis.

Criar o projeto

Siga este procedimento para criar uma solução Visual Studio e um novo projeto web Flask:

  1. No Visual Studio, selecione Ficheiro>Novo>Projeto e procure por "Flask." Selecione o modelo Blank Flask Web Project e selecione Próximo.

    Captura de ecrã que mostra como selecionar o modelo Blank Flask Web Project no Visual Studio 2022.

  2. O Visual Studio mostra o diálogo de configuração do projeto. Introduza um Nome para o projeto e selecione Criar. Podes deixar os outros campos definidos nos predefinidos.

    Captura de ecrã que mostra como configurar um novo Projeto Web Blank Flask no Visual Studio 2022.

  3. Após um momento, o Visual Studio apresenta um prompt sobre como lidar com dependências de pacotes. O prompt é diferente consoante se já tem dependências de pacotes instaladas.

    O diálogo Este projeto requer pacotes externos. indica que o modelo selecionado inclui um ficheirorequirements.txt que especifica dependências no pacote Flask. O Visual Studio pode instalar os pacotes automaticamente, o que lhe dá a opção de os instalar num ambiente virtual. Recomenda-se usar um ambiente virtual em vez de instalar num ambiente global.

    Se receber este diálogo, selecione a opção Instalar num ambiente virtual :

    Captura de ecrã do prompt para instalar as dependências de pacotes necessárias num ambiente virtual no Visual Studio.

    Alternativamente, pode ver que o ficheiro de especificação do pacote Python "requirements.txt" foi detetado no projeto <Nome do projeto>". aviso no topo da janela do Visual Studio. Este prompt indica que as dependências do pacote já estão disponíveis na sua configuração. O Visual Studio pode criar um ambiente virtual para si a partir da configuração existente.

    Se vir este pedido, selecione a opção Criar ambiente virtual :

    Captura de tela do prompt que indica que um arquivo de requisitos para o projeto é detetado no Visual Studio.

  4. O Visual Studio mostra o diálogo Adicionar ambiente . Aceita os valores padrão e seleciona Criar, depois consente a quaisquer pedidos de elevação.

    Captura de ecrã que mostra como adicionar um ambiente virtual para o projeto Flask no Visual Studio 2022.

Sugestão

Quando começa um projeto, é altamente recomendado criar um ambiente virtual imediatamente, como a maioria dos modelos do Visual Studio o convida a fazer. Os ambientes virtuais mantêm os requisitos exatos do seu projeto ao longo do tempo, à medida que adiciona e remove bibliotecas. Pode então gerar facilmente um ficheirorequirements.txt , que usa para reinstalar essas dependências noutros computadores de desenvolvimento (como ao usar controlo de versão) e ao implementar o projeto num servidor de produção. Para mais informações sobre ambientes virtuais e os seus benefícios, consulte Utilizar ambientes virtuais e Gerir pacotes necessários com requirements.txt.

Examine o código clichê

Nesta secção, examina o código padrão no ficheiro de projeto Flask (.py) que o Visual Studio cria para o modelo selecionado.

  1. Abra o Explorador de Soluções para ver a sua solução e os ficheiros do projeto Flask. O projeto inicial contém apenas dois arquivos, app.py e requirements.txt:

    Captura de tela que mostra os arquivos iniciais do projeto Flask no Gerenciador de Soluções.

    O arquivo requirements.txt especifica as dependências do pacote Flask. A presença desse arquivo é o que convida você a criar um ambiente virtual ao criar o projeto pela primeira vez.

    O único ficheiro app.py contém código padrão para um projeto web Flask em branco. O modelo fornece código semelhante às descrições no artigo Quickstart - Criar uma aplicação web com Flask , com algumas secções adicionais.

  2. Abra o ficheiro app.py no editor e examine a secção superior.

    O código começa com uma import instrução para o pacote Flask. Esta instrução cria uma instância da Flask classe, que é atribuída à variável app:

    from flask import Flask
    app = Flask(__name__)
    

    De seguida, o código atribui a wsgi_app variável, o que é útil quando se implementa a aplicação Flask num alojamento web:

    # Make the WSGI interface available at the top level so wfastcgi can get it.
    wsgi_app = app.wsgi_app
    
  3. A secção do meio atribui uma função a uma rota URL, o que significa que a função fornece o recurso identificado pela URL. Neste caso, a rota define uma vista:

    @app.route('/')
    def hello():
        """Renders a sample page."""
        return "Hello World!"
    

    Você define rotas usando o decorador @app.route do Flask com um argumento que é a URL relativa a partir do ponto de origem do site. Como você pode ver no código, a função retorna apenas uma cadeia de texto, que é suficiente para um navegador renderizar.

  4. A secção inferior contém código opcional para iniciar o servidor de desenvolvimento Flask. Podes definir o host e a port através de variáveis de ambiente em vez de as codificar fixamente. Este tipo de código permite-lhe controlar facilmente a configuração tanto em máquinas de desenvolvimento como de produção sem alterar o código:

    if __name__ == '__main__':
        import os
        HOST = os.environ.get('SERVER_HOST', 'localhost')
        try:
            PORT = int(os.environ.get('SERVER_PORT', '5555'))
        except ValueError:
            PORT = 5555
        app.run(HOST, PORT)
    
  5. Selecione Debug>Iniciar sem Depuração para executar a aplicação Flask e abrir um navegador no valor predefinido do host e da porta, localhost:5555.

Explore modelos Python no Visual Studio

Quando instala a carga de trabalho em Python, o Visual Studio fornece vários modelos de projeto para os frameworks web Flask, Bottle e Django , bem como para os serviços cloud Azure. Existem também modelos para diferentes cenários de aprendizagem automática e um modelo para criar um projeto a partir de uma estrutura de pastas existente que contenha uma aplicação Python. Pode aceder aos modelos usando a opção de menu Fichar>Novo>Projeto . Selecione o nó da linguagem Python e os seus nós filhos para ver os modelos disponíveis.

O Visual Studio também disponibiliza vários modelos de ficheiros ou itens para criar rapidamente uma classe Python, um pacote Python, um teste unitário Python, web.config ficheiros e muito mais. Quando tem um projeto Python aberto, acede aos modelos de itens usando a opção de menu Adicionar Novo Item do Projeto>. Para obter mais informações, consulte a referência de modelos de item .

Usar modelos pode poupar-lhe bastante tempo ao iniciar um projeto ou criar um ficheiro. Também são uma ótima forma de aprender sobre diferentes tipos de aplicações e estruturas de código. É útil dedicar alguns minutos a criar projetos e itens a partir dos vários modelos para se familiarizar com o que oferecem.

Use modelos Cookiecutter

O Visual Studio oferece integração direta com o Cookiecutter para o ajudar a descobrir templates, introduzir opções de templates e criar projetos e ficheiros. Para mais informações, consulte o artigo Quickstart: Criar um projeto a partir de um modelo Cookiecutter .