Exercício – Criar seu primeiro projeto

6 minutos

Agora que exploramos alguns conceitos básicos do Django, vamos começar a criar o projeto.

Criar um projeto com Django-admin

Conforme realçado anteriormente, um projeto do Django é o contêiner para todo o nosso projeto e todos os aplicativos que criamos. Vamos criar o projeto.

Na janela do terminal no Visual Studio Code, execute o seguinte comando:

django-admin startproject helloproject .

Importante

O ponto à direita no final do comando é importante. Ele instrui django-admin a usar a pasta atual. Se você não usar o ponto, um subdiretório adicional será criado.

Após a execução do comando anterior, o novo projeto deve estar no diretório escolhido. Neste caso, você veria uma nova pasta chamada helloproject.

Explorar a estrutura do projeto

Agora que o projeto do Django foi criado, vamos examinar a estrutura para ver o que foi incluído.

manage.py
helloproject/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py

O utilitário de linha de comando manage.py é criado em todos os projetos do Django. Ele tem a mesma função que django-admin. O exemplo a seguir mostra como ele poderia ser usado se você estivesse dentro da pasta do projeto e quisesse ver os subcomandos disponíveis.
```
python manage.py help
```
helloproject é considerado o pacote de Python de seu projeto.
init.py é um arquivo vazio que funciona para dizer ao Python que esse diretório deve ser considerado um pacote.
settings.py contém todas as configurações ou definições.
urls.py contém as URLs dentro do projeto.
asgi.py e wsgi.py servem como ponto de entrada para os servidores Web dependendo do tipo de servidor implantado.

Executar o projeto

Agora que o Django está instalado, um projeto foi criado e examinamos a estrutura do projeto, é hora de verificar se o projeto está funcionando corretamente.

Dentro da janela do terminal no Visual Studio Code, insira o código a seguir para iniciar o servidor.
```
python manage.py runserver
```
O projeto executa verificações de sistema e inicia o servidor de desenvolvimento. Copie e cole a URL do servidor de desenvolvimento, que deve ser http://localhost:8000, no navegador de sua preferência. Você deve ver uma página de Parabéns do Django com uma imagem de um foguete decolando.
Pare o servidor temporariamente, pois precisaremos reconfigurar o projeto. Dentro da janela do terminal, selecione Ctrl + C.

Criar o aplicativo Olá, Mundo

Aprendemos as noções básicas sobre a estrutura do Django e examinamos a estrutura de pastas do projeto. Agora, é hora de criar nosso primeiro aplicativo! O aplicativo Olá, mundo! ajudará você a entender como os aplicativos são criados e como eles funcionam em harmonia com o projeto Django.

Na janela do terminal, execute o comando a seguir para criar o aplicativo.

python manage.py startapp hello_world

Com esse comando, o Django cria as pastas e os arquivos necessários, e a estrutura a seguir deve estar visível.

hello_world/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

Registrar aplicativo com projeto

Como aplicativos e projetos são separados no Django, você deve registrar seu aplicativo no projeto. Isso é feito atualizando a variável INSTALLED_APPS dentro de settings.py para o projeto, adicionando uma referência à classe de configuração do aplicativo. A classe de configuração é encontrada em apps.py e tem o mesmo nome do projeto. Em nosso exemplo, a classe será nomeada HelloWorldConfig.

Dentro de helloproject, abra settings.py.
Localize a lista INSTALLED_APPS, que deve estar na linha 33.
Adicione o seguinte ao final da lista, dentro dos colchetes ([ ]):
```
'hello_world.apps.HelloWorldConfig',
```

A lista INSTALLED_APPS atualizada se parece com o seguinte:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world.apps.HelloWorldConfig',
]

Salve todos os arquivos selecionando Arquivo>Salvar tudo.

Parabéns! Você criou seu primeiro projeto e aplicativo Django. Em seguida, é criar um caminho e uma exibição para adicionar algumas funcionalidades.

Continuar