Uzed Dev Mobile

Ferramenta desktop livre da Uzed para descobrir, conectar e controlar dispositivos Android na rede local — com ADB, espelhamento de tela (scrcpy), instalação de APK e um companion no celular/tablet.

Licença: Apache License 2.0

---

O que faz

O Uzed Dev Mobile é um gerenciador gráfico para o dia a dia de desenvolvimento mobile:

• Lista dispositivos conectados por USB ou Wi‑Fi (ADB)
• Procura na rede (mDNS, porta :5555, beacon do companion e scan)
• ADB Wi‑Fi — libera depuração sem cabo (com companion no aparelho)
• scrcpy — espelha e controla a tela do Android no PC
• Build + APK — compila um projeto Flutter/Gradle e instala no aparelho
• Mostra IP e MAC do dispositivo (com cópia rápida do MAC)
• Companion Android Uzed Dev Mobile com ícone próprio, status de porta/beacon e botões Liberar / Desativar

Ideal para quem desenvolve apps Android e quer menos fricção entre cabo, Wi‑Fi e instalação.

---

Componentes

Pasta / item	Descrição
dev_mobile/	App desktop (Python + CustomTkinter)
adb-wifi/	Companion Flutter/Android (beacon + ADB Wi‑Fi)
install.py	Instalador (venv, dependências, atalho no menu/dock)
run.py	Execução rápida sem reinstalar
scripts/	Utilitários (ex.: preparar tablet para debug)

---

Requisitos

• Linux (testado no Ubuntu/GNOME) ou Windows
• Python 3.10+
• ADB (android-tools-adb / platform-tools)
• scrcpy (opcional, recomendado)
• Flutter (para build do companion e de projetos Flutter)

# Exemplo Ubuntu
sudo apt install android-tools-adb scrcpy python3-venv

---

Instalação rápida

git clone https://github.com/zedmaster/uzed-dev-mobile.git
cd dev-mobile
python3 install.py

Ajuste a URL do git clone se o repositório estiver sob outra organização/conta. Depois abra Uzed Dev Mobile pelo menu de aplicativos ou:

./dev-mobile.sh          # gerado pelo install
# ou
python3 run.py

---

Companion no celular/tablet (ADB Wi‑Fi)

1. Conecte o aparelho por USB e aceite a depuração
2. No app desktop, clique em Instalar ADB Wi‑Fi (USB)
3. No aparelho, abra Uzed Dev Mobile e toque em Liberar ADB Wi‑Fi
4. No PC, use Procurar na rede ou Atualizar lista
5. Pode desconectar o cabo

Com o app do PC aberto na mesma rede, Desativar no companion envia um pedido para o desktop fechar o ADB TCP (adb usb). Sem root, o aparelho sozinho não consegue sempre derrubar a porta :5555.

---

Build + APK de outro projeto

No card do dispositivo, Build + APK:

• Escolhe (ou confirma) a pasta do app Flutter/Gradle
• Gera APK release e instala no aparelho
• O caminho da pasta é lembrado entre sessões (~/.config/uzed-dev-mobile/settings.json)

---

Stack

• Desktop: Python, CustomTkinter, Pillow, ADB, scrcpy
• Companion: Flutter / Kotlin (Android)
• Licença do projeto: Apache-2.0

Ferramentas externas (scrcpy, Flutter SDK, ADB) mantêm as licenças próprias; o scrcpy, por exemplo, é GPL e deve ser instalado no sistema — não é redistribuído como biblioteca deste repositório.

---

Sobre a Uzed

Projeto mantido pela Uzed para apoiar desenvolvimento mobile e divulgar o ecossistema Uzed.

• Site: uzed.com.br

Contribuições e feedback são bem-vindos via issues/PRs neste repositório.

---

Licença

Copyright © 2026 Uzed

Licensed under the Apache License, Version 2.0. Veja o arquivo LICENSE para o texto completo.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0