https://github.com/maxpicelli/clover-compiler-builder
🍀 Clover Builder v14 - App bundle para macOS que facilita a compilação do Clover Bootloader com suporte ao macOS Tahoe Beta
https://github.com/maxpicelli/clover-compiler-builder
bootloader clover hackintosh macos shell-script
Last synced: about 2 months ago
JSON representation
🍀 Clover Builder v14 - App bundle para macOS que facilita a compilação do Clover Bootloader com suporte ao macOS Tahoe Beta
- Host: GitHub
- URL: https://github.com/maxpicelli/clover-compiler-builder
- Owner: maxpicelli
- Created: 2025-10-05T15:24:01.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T15:50:52.000Z (9 months ago)
- Last Synced: 2025-10-05T17:39:30.855Z (9 months ago)
- Topics: bootloader, clover, hackintosh, macos, shell-script
- Language: Shell
- Size: 1.94 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🍀 Clover Builder v14.3
Um app bundle para macOS que facilita a compilação do Clover Bootloader através de uma interface simples e intuitiva, com gerenciamento automático de dependências e detecção inteligente de binários.
## 🚀 Instalação Rápida (Recomendado)
Execute este comando no Terminal para instalar automaticamente:
```bash
curl -fsSL https://raw.githubusercontent.com/maxpicelli/Clover-Compiler-Builder/main/setup.sh | bash
```
**O que este comando faz:**
- ✅ Clona o repositório do GitHub
- ✅ Cria o aplicativo CloverBuilderv14.app automaticamente
- ✅ Configura todas as permissões necessárias
- ✅ Abre a pasta onde foi instalado
- ✅ Opcionalmente inicia o app
**OU** clone manualmente:
```bash
git clone https://github.com/maxpicelli/Clover-Compiler-Builder.git
cd Clover-Compiler-Builder
chmod +x setup.sh
./setup.sh
```
---
## 📋 Descrição
O Clover Builder v14.3 é um aplicativo macOS que automatiza o processo de compilação do Clover Bootloader. Ele abre o Terminal automaticamente e executa o script de build, tornando o processo mais acessível e organizado. A versão 14.3 inclui gerenciamento automático de dependências, detecção inteligente de binários compilados e correção automática de problemas comuns.
## 🎯 Características
- ✅ Interface nativa do macOS (.app bundle)
- ✅ Ícone personalizado
- ✅ Abertura automática do Terminal
- ✅ Script de build integrado
- ✅ Fácil de usar - basta dar duplo clique
- ✅ **NOVO v14.3:** Detecção automática de Anaconda
- ✅ **NOVO v14.3:** Correção automática de dependências Python
- ✅ **NOVO v14.3:** Verificação e reparo automático do Xcode Command Line Tools
- ✅ **NOVO v14.3:** Gerenciamento inteligente de binários compilados
- ✅ **NOVO v14.3:** Compatibilidade aprimorada com macOS Tahoe Beta
## 📦 Estrutura de Arquivos
```
pasta-do-projeto/
├── Criar Clover Builder - make_app # ← Dê duplo clique aqui para criar o app!
├── CloverCompilerBuilder.sh # Script principal de compilação
├── icone.icns # Ícone do aplicativo
├── setup.sh # Script de instalação automática
└── CloverBuilderv14.app # App gerado (após criar)
```
## 🚀 Como Usar
### Primeira vez (Criar o App)
**É super simples!** Basta dar **duplo clique** no arquivo:
```
Criar Clover Builder - make_app
```
O aplicativo `CloverBuilderv14.app` será criado automaticamente na mesma pasta! 🎉
**Alternativa via Terminal:**
```bash
cd /caminho/para/sua/pasta
./"Criar Clover Builder - make_app"
```
### Uso Normal
Após criar o app, simplesmente:
1. **Dê duplo clique** no `CloverBuilderv14.app`
2. O Terminal será aberto automaticamente
3. O script de build do Clover será executado
## 🆕 Novidades da v14.3
### 🔧 Gerenciamento Automático de Dependências
- **Detecção automática** de Anaconda instalado
- **Ativação automática** do ambiente Anaconda base
- **Correção automática** de problemas com `distutils.util`
- **Instalação automática** de `setuptools` com múltiplos métodos de fallback
- **Verificação e reparo** automático do Xcode Command Line Tools
### 📦 Gerenciamento Inteligente de Binários
- **Detecção automática** de binários compilados salvos
- **Restauração automática** de binários para evitar downloads desnecessários
- **Salvamento automático** de binários após compilação bem-sucedida
- **Opções flexíveis** de gerenciamento (usar atuais, salvar, restaurar salvos)
### 🛠️ Melhorias de Compatibilidade
- **Compatibilidade aprimorada** com macOS Tahoe Beta (26.x)
- **Priorização** de ferramentas Homebrew estáveis
- **Validação robusta** de estrutura de repositório
- **Tratamento de erros** melhorado com mensagens claras
## 🔧 Requisitos
- macOS (qualquer versão moderna)
- Terminal
- Xcode Command Line Tools (para compilação do Clover)
- **Python Anaconda 3.9.x** (3.9.6 para Intel / 3.9.13 para ARM64) - recomendado
- Permissões de execução nos scripts
### 🐍 Por que Python Anaconda 3.9.x?
O **Python Anaconda 3.9.x** é recomendado porque:
- ✅ Máxima compatibilidade com o script de compilação do Clover
- ✅ Ambiente Python completo e estável
- ✅ Evita conflitos com outras versões do Python no sistema
- ✅ Testado e aprovado para builds do Clover Bootloader
**Downloads por arquitetura:**
| Arquitetura | Versão | Python | Download |
|------------|--------|--------|----------|
| **Apple Silicon (ARM64)** ⭐ | v3-2025.06 | 3.13 | [Anaconda3-2025.06-0-MacOSX-arm64.pkg](https://repo.anaconda.com/archive/Anaconda3-2025.06-0-MacOSX-arm64.pkg) |
| **Intel (x86_64)** ⭐ | v3-2025.06 | 3.13 | [Anaconda3-2025.06-0-MacOSX-x86_64.pkg](https://repo.anaconda.com/archive/Anaconda3-2025.06-0-MacOSX-x86_64.pkg) |
| **Apple Silicon (ARM64)** | v3-2022.05 | 3.9.13 | [Anaconda3-2022.05-MacOSX-arm64.pkg](https://repo.anaconda.com/archive/Anaconda3-2022.05-MacOSX-arm64.pkg) |
| **Intel (x86_64)** | v3-2021.11 | 3.9.6 | [Anaconda3-2021.11-MacOSX-x86_64.pkg](https://repo.anaconda.com/archive/Anaconda3-2021.11-MacOSX-x86_64.pkg) |
> **⭐ Versão 2025.06 (MAIS RECENTE - RECOMENDADA):**
> - ✅ **Testado e funcionando perfeitamente com o script!**
> - Python 3.13 totalmente compatível
> - Links diretos acima para download rápido
> - Ou visite: [anaconda.com/download/success](https://www.anaconda.com/download/success)
> **Como saber qual usar?**
> - **Macs M1/M2/M3/M4**: Use ARM64
> - **Macs Intel**: Use x86_64
> - **Dúvida?** Execute no Terminal: `uname -m` (resultado: `arm64` ou `x86_64`)
> - **Macs Apple Silicon também podem usar a versão x86_64 via Rosetta 2**
> **Nota:** O script funciona com Python 3.9+ (incluindo 3.13). As versões Anaconda oferecem ambiente completo e estável, sendo a **2025.06 a mais atualizada e recomendada**.
## 📝 O que o criador de app faz?
O arquivo executável `Criar Clover Builder - make_app` automatiza a criação do app bundle:
1. Detecta automaticamente a pasta onde está localizado
2. Cria a estrutura de pastas do app bundle (.app/Contents/MacOS e Resources)
3. Gera o arquivo `Info.plist` com as configurações do app
4. Cria um launcher que abre o Terminal e executa o script
5. Copia o script de build (`CloverCompilerBuilder.sh`) para dentro do app
6. Copia e configura o ícone personalizado
7. Define as permissões corretas de execução
8. Remove atributos estendidos que poderiam causar problemas
9. Atualiza o cache do Finder para exibir o ícone
## 🎨 Personalizando o Ícone
O app aceita ícones nos formatos:
- `.icns` (formato nativo do macOS) - **recomendado**
- `.icon` (será convertido automaticamente para .icns)
Para criar um ícone .icns a partir de uma imagem:
```bash
sips -s format icns sua-imagem.png --out icone.icns
```
## 🔒 Segurança
O script remove automaticamente atributos de quarentena (`xattr -cr`) para evitar avisos de segurança do macOS. O app não é assinado digitalmente, mas como é criado localmente, o macOS permite sua execução.
Se aparecer um aviso de segurança na primeira execução:
1. Clique com o botão direito no app
2. Selecione "Abrir"
3. Confirme "Abrir" novamente
## 🐛 Solução de Problemas
### O ícone não aparece
```bash
killall Finder
```
### Símbolo de proibido no app
Execute:
```bash
xattr -cr CloverBuilderv14.app
```
### Script não executa
Verifique as permissões:
```bash
chmod 755 CloverBuilderv14.app/Contents/MacOS/run
chmod 755 CloverBuilderv14.app/Contents/Resources/builder.sh
```
### Erro "CloverCompilerBuilder.sh não encontrado"
Certifique-se de que o arquivo `CloverCompilerBuilder.sh` está na mesma pasta que o `Criar Clover Builder - make_app` antes de criar o app.
## 📂 Portabilidade
O criador de app é totalmente portátil! Você pode:
- Copiar a pasta inteira para qualquer lugar
- Executar com duplo clique em qualquer diretório
- Não precisa editar caminhos hardcoded
O script detecta automaticamente sua localização, tornando tudo simples e fácil.
## 🔄 Atualizando o App
Para atualizar o app após modificar o script de build:
1. Delete o app antigo `CloverBuilderv14.app` (ou apenas sobrescreva)
2. Dê duplo clique novamente em `Criar Clover Builder - make_app`
3. O novo app será criado com as alterações
## 📄 Licença
Este é um script utilitário para criar um app bundle. Verifique a licença do Clover Bootloader separadamente.
## 🤝 Contribuindo
Sinta-se à vontade para modificar e adaptar o script às suas necessidades!
## 📞 Suporte
Se encontrar problemas:
1. Verifique se todos os arquivos necessários estão presentes
2. Confirme as permissões de execução
3. Verifique a seção "Solução de Problemas" acima
4. Execute o script manualmente no Terminal para ver mensagens de erro
---
**Versão:** 14.3-complete
**Última atualização:** Janeiro 2025
**Compatibilidade:** macOS 10.13+ (incluindo macOS Tahoe Beta)
🍀 Happy Building!