Começando

Guia completo para setup e configuração inicial do projeto Camera App.

📋 Requisitos de Sistema

Requisitos Mínimos

• Xcode: 16.4 ou superior
• iOS Deployment Target: 18.5 ou superior
• Swift: 5.9+
• macOS: 13.0+ (para rodar Xcode 16.4)
• Device Físico: iPhone ou iPad com iOS 18.5+

🚀 Instalação

1. Clone o Repositório

git clone https://github.com/Pedroodelvalle/camera-swift.git
cd camera-swift

2. Abra no Xcode

open Camera.xcodeproj

Ou abra manualmente:

• Abra o Xcode
• File → Open
• Selecione Camera.xcodeproj

3. Configure o Signing

1. Selecione o projeto Camera no navegador
2. Vá para Signing & Capabilities
3. Selecione seu Team (conta Apple ID)
4. Xcode irá gerar automaticamente o provisioning profile

4. Conecte seu Device

1. Conecte iPhone/iPad via USB
2. Desbloqueie o device
3. Confie no computador se solicitado
4. Selecione o device no seletor de destinos do Xcode

5. Build e Run

Pressione ⌘ + R ou clique no botão Play.

🔐 Permissões Necessárias

A aplicação requer as seguintes permissões (já configuradas no projeto):

Camera.entitlements

<key>NSCameraUsageDescription</key>
<string>Necessário para gravar vídeos</string>

<key>NSMicrophoneUsageDescription</key>
<string>Necessário para gravar áudio</string>

<key>NSPhotoLibraryAddUsageDescription</key>
<string>Necessário para salvar vídeos gravados</string>

Essas permissões são solicitadas automaticamente na primeira execução.

🏗️ Estrutura do Projeto

Camera/
├── Assets.xcassets/           # Recursos visuais
├── CameraApp.swift            # Entry point (@main)
├── ContentView.swift          # View principal
├── CameraViewModel.swift      # Estado e lógica central
├── CaptureSessionController.swift  # Gerenciamento AVFoundation
├── SegmentedRecorder.swift    # Gravação de takes
├── CameraPreviewView.swift    # Preview UIKit bridge
├── TeleprompterOverlay.swift  # UI do teleprompter
├── TeleprompterTextView.swift # Scroll do teleprompter
├── TeleprompterViewModel.swift # Lógica do teleprompter
├── GlassCompat.swift          # Componentes UI reutilizáveis
└── Camera.entitlements        # Permissões

Camera.xcodeproj/              # Configuração do projeto

🔧 Build Configuration

Target Settings

PRODUCT_NAME: Camera
PRODUCT_BUNDLE_IDENTIFIER: com.pedro.Camera
DEVELOPMENT_TEAM: (seu team ID)
CODE_SIGN_STYLE: Automatic
TARGETED_DEVICE_FAMILY: 1,2 (iPhone e iPad)
IPHONEOS_DEPLOYMENT_TARGET: 18.5
SWIFT_VERSION: 5.9

Capabilities

• Camera: Acesso à câmera frontal e traseira
• Microphone: Gravação de áudio
• Photo Library: Salvamento de vídeos

🧪 Primeira Execução

O que esperar:

1. Splash Screen: Tela preta com logo
2. Permissões: Sistema irá solicitar 3 permissões
   • Aceite todas para funcionamento completo
3. Preview da Câmera: Interface principal será exibida
4. Câmera Frontal: Inicia com câmera frontal por padrão

Testando Funcionalidades Básicas

🐛 Troubleshooting

Erro: “Privacy-sensitive data”

Problema: App crasha ao acessar câmera

Solução:

• Verifique se as keys estão no Info.plist ou Camera.entitlements
• Limpe o build (⌘ + Shift + K)
• Rebuild o projeto

Erro: Signing Failed

Problema: Não consegue fazer build

Solução:

1. Xcode → Preferences → Accounts
2. Adicione sua Apple ID
3. Baixe os certificados
4. Selecione seu Team no projeto

Device Não Aparece

Problema: iPhone não aparece no seletor

Solução:

1. Reconecte o cabo USB
2. Desbloqueie o iPhone
3. Confie no computador
4. Window → Devices and Simulators
5. Verifique se o device aparece

Câmera Preta / Não Funciona

Problema: Preview mostra tela preta

Solução:

• Use device físico (não funciona em simulator)
• Verifique se aceitou as permissões
• Settings → Camera → Permissões
• Delete o app e reinstale

Torch Não Funciona

Problema: Flash não acende

Solução:

• Back Camera: Requer device físico com flash
• Front Camera: Aumenta brilho da tela (sempre funciona)
• Verifique se device está em low power mode

📱 Devices Testados

O projeto foi testado nos seguintes devices:

📚 Próximos Passos

Agora que você tem o projeto rodando:

1. Entenda a Arquitetura - Aprenda sobre MVVM e fluxo de dados
2. Explore os Componentes - Documentação detalhada de cada módulo
3. Veja os Guias - Tutoriais práticos de uso

🆘 Precisa de Ajuda?

• Documentação: Continue lendo as outras seções
• Issues: Abra uma issue no GitHub
• Código: Explore o source code com comentários inline