Exercício - Crie o seu primeiro projeto

6 minutos

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

Criar um projeto com Django-admin

Como destacado anteriormente, um projeto Django é o contêiner para todo o nosso projeto e quaisquer aplicativos que criamos. Vamos criar o nosso projeto.

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

django-admin startproject helloproject .

Importante

O período de fuga no final do comando é importante. Ele instrui django-admin a usar a pasta atual. Se você deixar o período, ele criará um subdiretório adicional.

Depois de executar o comando anterior, o novo projeto agora deve estar no diretório escolhido. Neste caso, você veria uma nova pasta chamada helloproject.

Explorar a estrutura do projeto

Agora que o projeto Django foi criado, vamos olhar para 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 cada projeto Django. Tem a mesma função que o 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 Python para o 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 suas definições ou configurações.
urls.py contém as URLs dentro do projeto.
asgi.py e wsgi.py servem como ponto de entrada para seus 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 garantir que nosso projeto esteja funcionando corretamente.

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

Criar o aplicativo Hello World

Aprendemos o básico sobre a estrutura do Django e examinamos a estrutura de pastas do nosso 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 uníssono com o projeto Django.

Dentro da janela do terminal , execute o seguinte comando para criar o aplicativo.

python manage.py startapp hello_world

Com esse comando, o Django cria as pastas e arquivos necessários, e a estrutura a seguir agora 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 os aplicativos e projetos são separados no Django, você deve registrar seu aplicativo com o projeto. Isso é feito atualizando a INSTALLED_APPS variável dentro settings.py para o projeto, adicionando uma referência à classe config para o aplicativo. A classe config é encontrada em apps.py e é o mesmo nome do projeto. No nosso exemplo, a classe será nomeada HelloWorldConfig.

Dentro do helloproject, abra settings.py.
Encontre a lista INSTALLED_APPS, que deve estar na linha 33.
Aditar o seguinte ao final da lista, entre parênteses retos ([ ]):
```
'hello_world.apps.HelloWorldConfig',
```

A lista atualizada INSTALLED_APPS deve ter a seguinte aparência:

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.