Thay giao diện Android TV Box: dọn ứng dụng rác và cài launcher Tivi Home có âm lịch, thời tiết và khoá trẻ em

Kiểm tra: trong C:\tivibox\tivihome phải thấy thư mục app và file build.ps1. Nếu có thêm một tầng thư mục (giải nén lồng), chuyển nội dung bên trong ra ngoài.

2c. Tải JDK 17

1. Vào adoptium.net/temurin/releases/?version=17, chọn Windows · x64 · JDK, tải bản .zip.
2. Giải nén vàoC:\tivibox\buildtools\jdk\,được thư mục kiểu jdk-17.0.x+y.

1. Vào developer.android.com/studio, mục Command line tools only, tải commandlinetools-win-..._latest.zip.
2. Giải nén vào C:\tivibox\buildtools\, được thư mục cmdline-tools\bin\.
3. Mở PowerShell trongC:\tivibox và chạy (bấmykhi được hỏi đồng ý giấy phép):

cd C:\tivibox
$env:JAVA_HOME = (Get-ChildItem .\buildtools\jdk -Directory)[0].FullName
.\buildtools\cmdline-tools\bin\sdkmanager.bat --sdk_root=.\buildtools\android-sdk --licenses
.\buildtools\cmdline-tools\bin\sdkmanager.bat --sdk_root=.\buildtools\android-sdk "platform-tools" "platforms;android-34" "build-tools;34.0.0"

Xong bước này, adb.exe nằm ở C:\tivibox\buildtools\android-sdk\platform-tools\.

2e. Hoặc: chỉ tải APK có sẵn (không cần build)

1. Mở mục Releases của repo: github.com/tuanpa-1702/restore-your-tivi/releases, tải fileTiviHome-x.y.apk mới nhất và file.sha256 đi kèm vàoC:\tivibox.
2. Tải riêng SDK Platform-Tools for Windows tại developer.android.com/tools/releases/platform-tools, giải nén vào C:\tivibox\buildtools\android-sdk\để cóplatform-tools\adb.exe.
3. Kiểm tra file APK không bị sửa: so mã in ra với mã trong file.sha256 (thayx.y bằng số phiên bản bạn tải):

Get-FileHash C:\tivibox\TiviHome-x.y.apk -Algorithm SHA256

Bước 3: Kết nối ADB từ máy tính

Mở PowerShell trongC:\tivibox\buildtools\android-sdk\platform-toolsvà chạy:

# Kết nối tới TV (thay IP bằng IP thật của bạn)
.\adb.exe connect 192.168.1.50:5555
# Kiểm tra: phải thấy dòng "192.168.1.50:5555  device"
.\adb.exe devices

Lần đầu kết nối, TV hiện hộp thoại "Cho phép gỡ lỗi USB?". Dùng remote chọn Cho phép (có thể tick "Luôn cho phép từ máy tính này"). Nếu adb devices báo unauthorized, nghĩa là bạn chưa bấm cho phép.

Kiểm tra phiên bản Android, vì Tivi Home cần SDK 26 trở lên:

.\adb.exe shell getprop ro.product.model
.\adb.exe shell getprop ro.build.version.sdk     # phải từ 26 trở lên

Bước 4: Sao lưu trạng thái TV trước khi thay đổi bất cứ thứ gì

Đây là bước nhiều người bỏ qua nhất và cũng là bước cứu bạn khi có sự cố:

mkdir backup
.\adb.exe shell pm list packages -f > backup\packages.txt
.\adb.exe shell pm list packages -d > backup\disabled.txt
.\adb.exe shell settings list global > backup\settings-global.txt
.\adb.exe shell settings list secure > backup\settings-secure.txt
.\adb.exe shell settings list system > backup\settings-system.txt
.\adb.exe shell settings get secure default_input_method > backup\keyboard.txt
.\adb.exe shell settings get secure screensaver_components > backup\screensaver.txt
.\adb.exe shell settings get system screen_off_timeout >> backup\screensaver.txt

Ghi lại tên launcher đang dùng, bạn sẽ cần nó để quay lại:

.\adb.exe shell cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.HOME

Không đưa thư mục backup lên mạng: các file này chứa số serial, tên thiết bị và tên Wi-Fi của bạn.

Bước 5: Build và cài Tivi Home

Nếu tự build (đã làm 2a → 2d): mở PowerShell trongC:\tivibox\tivihomevà chạy. Script tự chạy bộ kiểm thử (âm lịch, đặt dấu tiếng Việt, Telex) rồi mới đóng gói APK:

cd C:\tivibox\tivihome
powershell -ExecutionPolicy Bypass -File build.ps1

Kết quả làbuild\TiviHome.apk.Lần build đầu tạo khoá kýdebug.keystore.Hãy giữ file này: bản cập nhật sau phải ký bằng đúng khoá này mới cài đè được.

Cài lên TV:

powershell -ExecutionPolicy Bypass -File install.ps1 -Tv 192.168.1.50

Script đẩy APK lên TV, cài bằng pm install (tránh adb install bị treo trên Android 14), cấp quyền cho khoá trẻ em, đọc ảnh và đổi màn hình chờ, rồi mở ứng dụng.

Nếu dùng APK có sẵn (bước 2e): chạy trong C:\tivibox\buildtools\android-sdk\platform-tools, thay x.y bằng số phiên bản bạn tải:

.\adb.exe push C:\tivibox\TiviHome-x.y.apk /data/local/tmp/TiviHome.apk
.\adb.exe shell pm install -r /data/local/tmp/TiviHome.apk
.\adb.exe shell rm /data/local/tmp/TiviHome.apk
# Khoá trẻ em: hiển thị trên ứng dụng khác
.\adb.exe shell appops set com.tivibox.home SYSTEM_ALERT_WINDOW allow
# Ảnh nền và trình chiếu: đọc ảnh (Android 12 trở xuống thay bằng READ_EXTERNAL_STORAGE)
.\adb.exe shell pm grant com.tivibox.home android.permission.READ_MEDIA_IMAGES
# Màn hình chờ: đặt Tivi Home làm màn hình chờ của TV và đổi thời gian chờ
.\adb.exe shell pm grant com.tivibox.home android.permission.WRITE_SECURE_SETTINGS
.\adb.exe shell appops set com.tivibox.home WRITE_SETTINGS allow
# Giữ quyền sau khi khởi động lại
.\adb.exe shell appops write-settings
.\adb.exe shell am start -n com.tivibox.home/.MainActivity

Ở bước này launcher cũ vẫn là màn hình chính, bấm Home là về giao diện cũ. Dùng thử Tivi Home vài phút trước khi đi tiếp.

Bước 6: Đặt Tivi Home làm màn hình chính

.\adb.exe shell cmd package set-home-activity com.tivibox.home/.MainActivity

Lệnh có thể in Success nhưng không đổi gì trên một số firmware. Đừng tin chữ Success: bấm nút Home trên remote, rồi kiểm tra ứng dụng đang ở trên cùng:

.\adb.exe shell "dumpsys activity activities | grep mFocusedApp"
# Kỳ vọng: ...com.tivibox.home/.MainActivity...

Chỉ khi dòng trên ra đúng com.tivibox.home mới chuyển sang bước 7.

Bước 7: Tắt launcher cũ (tắt, không gỡ)

# Thay <launcher-cũ> bằng tên gói bạn đã ghi lại ở bước 4
.\adb.exe shell pm disable-user --user 0 <launcher-cũ>

Khởi động lại TV một lần và xác nhận ba điều: TV vào thẳng Tivi Home, Wi-Fi vẫn kết nối, vàadb connectvẫn vào được.

Google TV: trình thiết lậpcom.google.android.tungsten.setupwraithcó thể giành lại nút Home sau khi tắt launcher gốc. Trước khi tắt nó, chạyadb shell "dumpsys wifi | grep -o 'cname=[^ ]*'": nếu mạng Wi-Fi đang dùng thuộc về setupwraith, tắt nó sẽ làm Android xoá mạng đó và bạn mất ADB. Khi đó hãy quên mạng rồi kết nối lại trong Cài đặt trước.

Board CVTE (có gói com.cvte.*): giữ nguyên launcher gốc, chỉ đặt Tivi Home làm Home và khởi động lại để kiểm tra.

Bước 8: Dọn ứng dụng hệ thống không dùng đến

Cảnh báo khi tắt ứng dụng hệ thống

Đây là bước rủi ro nhất của cả bài. Tắt nhầm một ứng dụng hệ thống có thể làm mất tín hiệu HDMI, mất remote, mất bàn phím, mất Wi-Fi hoặc không vào được Cài đặt. Hãy tuân thủ tuyệt đối các nguyên tắc dưới đây.

Nguyên tắc bắt buộc

• Chỉ tắt, không bao giờ gỡ: dùngpm disable-user --user 0. Tuyệt đối không dùngpm uninstallvới ứng dụng hệ thống, vì trên box không root bạn có thể không cài lại được.
• Mỗi lệnh một gói: gộp nhiều lệnhpmvào một dòng có thể dừng âm thầm sau lệnh đầu tiên mà không báo lỗi.
• Tắt theo nhóm nhỏ, kiểm tra sau mỗi nhóm: mở thử YouTube, HDMI, Cài đặt, bàn phím. Tắt một lúc 20 gói rồi TV lỗi thì bạn không biết gói nào là thủ phạm.
• Không hiểu thì không tắt: xem bằngadb shell dumpsys package <tên-gói>trước, còn mơ hồ thì để nguyên.
• Không bao giờ mở ứng dụng factory/test để xem thử: các gói có tên chứa factory,test, fac menu,mediatek.factorymenu, cvte.tv.hkcfac… Trên một số board, chỉ cần mở ra là TV bật cờ chế độ nhà máy: mất phím Input, mất HDMI-CEC, và lần khởi động sau tự tắt Play Services. Chỉ xem bằngdumpsys, không mở.
• Khởi động lại sau khi dọn xong: một số firmware tự bật lại gói đã tắt ở mỗi lần khởi động. So sánh pm list packages -dtrước và sau khi khởi động lại.

Tuyệt đối không tắt

Thường tắt an toàn (TV không dùng đến)

Ví dụ tắt một gói và kiểm tra:

.\adb.exe shell pm disable-user --user 0 com.google.android.tvrecommendations
# Package com.google.android.tvrecommendations new state: disabled-user
.\adb.exe shell pm list packages -d     # danh sách gói đang tắt

Một số gói được firmware bảo vệ và báo SecurityException: Cannot disable a protected package. Đó là bình thường, cứ bỏ qua, đừng tìm cách ép.

Bước 9: Bật Bàn phím Tivi (gõ Telex)

Bàn phím mặc định của nhiều box rất khó gõ tiếng Việt bằng remote. Tivi Home kèm một bàn phím hệ thống cùng phong cách, gõ Telex, dùng được trong mọi ứng dụng (ô tìm kiếm YouTube, mật khẩu Wi-Fi…). Bật trong Cài đặt → Bàn phím, hoặc:

.\adb.exe shell ime enable com.tivibox.home/.KeyboardService
.\adb.exe shell ime set com.tivibox.home/.KeyboardService

Bước 10: Cài đặt giao diện, ảnh nền và màn hình chờ

Mở Ứng dụng → Cài đặt giao diện (có thể thêm ô này vào dock). Các thẻ xếp 2 cột, bấm OK để đổi:

Lời chào và Vị trí thời tiết: gõ bằng Bàn phím Tivi; vị trí nhập tên thành phố hoặc quận/huyện, có dấu hay không dấu đều được.

Ảnh nền màn hình chính: Tivi Home tự quét mọi ảnh trong bộ nhớ trong và USB, hiện thành lưới (mới nhất trước), không cần duyệt thư mục. Chọn ảnh rồi chỉnh:

• Độ mờ: Rõ nét / Mờ nhẹ / Mờ nhiều.
• Cách hiển thị: Lấp đầy (cắt cho kín màn hình) hoặc Vừa khung (hiện trọn ảnh, phần thừa là nền mờ của chính ảnh).
• Bỏ ảnh nền để quay về màu nền gradient (Tím hồng, Đại dương, Hoàng hôn).

• Mẫu: Đồng hồ kính, Lịch âm dương, Thời tiết, Đêm tối giản, Ảnh nền, hoặc Tuỳ chỉnh (trình chiếu tối đa 30 ảnh tự chọn, mỗi ảnh 10 giây – 5 phút, bật/tắt đồng hồ).
• Xem thử: bấm phím bất kỳ để thoát.
• Thời gian chờ: 5 phút – 1 giờ hoặc tắt.
• Dùng làm màn hình chờ của TV: bấm để Tivi Home thay màn hình chờ cũ. Nếu app báo "Cần cấp quyền", chạy lại các lệnh cấp quyền ở bước 5, hoặc chọn "Màn hình chờ Tivi Home" trong cài đặt màn hình chờ của TV.

Nội dung màn hình chờ trôi nhẹ mỗi phút nên không lưu ảnh trên màn hình. Cuối trang Cài đặt giao diện ghi phiên bản đang cài.

Bước 11: Thiết lập khoá trẻ em

Bấm nút ổ khoá ở góc trên bên phải màn hình chính, chọn thời gian cho bé xem: 15 phút, 30 phút, 1 tiếng, 2 tiếng hoặc tuỳ chỉnh từ 1 đến 240 phút. Hết giờ, TV hiện màn hình khoá đè lên mọi ứng dụng (kể cả YouTube), tạm dừng phim và tắt tiếng. Rút điện hay khởi động lại cũng không thoát được khoá.

Mở khoá bằng mã PIN 8 số là ngày giờ hiện tại theo dạngddMMHHmm,ví dụ 25/10 lúc 18:54 thì mã là5101854.

Giới hạn của khoá trẻ em: công thức mã PIN được công bố công khai trong bài này và trong mã nguồn, nên đây là lớp nhắc nhở cho trẻ nhỏ, không phải biện pháp bảo mật. Khoá không chặn được việc chuyển nguồn HDMI, cast từ điện thoại hoặc vào Cài đặt Android buộc dừng ứng dụng. Nếu TV hỗ trợ, hãy đặt mật khẩu cho phần Cài đặt.

Bước 12: Đóng ADB khi đã xong việc

Cổng ADB 5555 truyền dữ liệu không mã hoá. Để mở là để ngỏ cửa: trên một số firmware, bất kỳ thiết bị nào trong mạng nhà bạn đều có thể chiếm quyền điều khiển TV. Khi đã làm xong:

1. Vào Tuỳ chọn nhà phát triển, tắt Gỡ lỗi USB và Gỡ lỗi ADB qua mạng.
2. Chọn Thu hồi quyền gỡ lỗi USB (Revoke USB debugging authorizations).
3. Khởi động lại TV, rồi thửadb connect 192.168.1.50:5555: phải báoConnection refusedmới là đã đóng.

Các quyền đã cấp ở bước 5 vẫn giữ nguyên sau khi đóng ADB.