Android常用系统定制

H618 Android 12.0 为官方 tv 系统,兼容 tv 版本的 APP,安装使用 tablet 或 phone 版本的 APP 可能会存在兼容性问题。

TV 桌面

开启Tablet对应的PRODUCT_PACKAGES

--- a/vendor/aw/homlet/homlet.mk
+++ b/vendor/aw/homlet/homlet.mk
@@ -16,12 +16,12 @@ PRODUCT_PACKAGES += \
     DragonSN  \
     GalleryTV

-#PRODUCT_PACKAGES += \
+PRODUCT_PACKAGES += \
     TvLauncher \
     TvSettings

-PRODUCT_PACKAGES += \
       Launcher3 \
+#PRODUCT_PACKAGES += \
       Launcher3 \
        Settings \
        SystemUI

APK 路径

vendor/aw/homlet/package/TVLauncher

Tablet 桌面

开启Tablet对应的PRODUCT_PACKAGES

--- a/vendor/aw/homlet/homlet.mk
+++ b/vendor/aw/homlet/homlet.mk
@@ -16,12 +16,12 @@ PRODUCT_PACKAGES += \
     DragonSN  \
     GalleryTV

-PRODUCT_PACKAGES += \
+#PRODUCT_PACKAGES += \
     TvLauncher \
     TvSettings

-#PRODUCT_PACKAGES += \
-       Launcher3 \
+PRODUCT_PACKAGES += \
+       Launcher3 \
        Settings \
        SystemUI

APK 路径

packages/apps/Launcher3/

APP 、文件编译不生效问题

android 为惰性编译,直接替换后编译,一些APP、文件不一定编译到镜像中

可以通过如下其中一种方式解决

  1. make installclean

  2. rm out/target/product/apollo-p2/xxx/xxx

  3. 编译的条件发生变化(比如文件名、APK名)

默认屏幕方向

默认修改显示方向

(SDK)$ android/device/softwinner/ceres-c3/ceres_c3.mk

# set primary display orientation to 270
PRODUCT_PROPERTY_OVERRIDES += \
    ro.surface_flinger.primary_display_orientation=ORIENTATION_0
    #feisi 
    #ro.surface_flinger.primary_display_orientation=ORIENTATION_90
    #ro.surface_flinger.primary_display_orientation=ORIENTATION_270

将ro.surface_flinger.primary_display_orientation=ORIENTATION_0

修改为

ro.surface_flinger.primary_display_orientation=ORIENTATION_90

即可修改屏幕默认显示旋转90°

logo 替换路径

longan/device/config/chips/h618/boot-resource/boot-resource/bootlogo.bmp

开机动画

支持 bootanimation.mp4 以及 bootanimation.zip 两种文件格式的开机动画

两种文件同时存在播放 mp4 优先级比 zip 高 ,具体优先级见 frameworks/base/cmds/bootanimation/BootAnimation.cpp

修改路径

device/softwinner/apollo/common/media/config.mk

bootanimation.zip 格式

PRODUCT_COPY_FILES += \
     $(BOOTANIMATION_CONFIG_PATH)/bootanimation.zip:system/media/bootanimation.zip

bootanimation.mp4 格式

PRODUCT_COPY_FILES += \
    $(BOOTANIMATION_CONFIG_PATH)/bootanimation.mp4:system/media/bootanimation.mp4
  • 烧录镜像后第一次启动的开机动画是原生Android,需要重启显示替换的开机动画

默认语言

persist.sys.locale 属性

device/softwinner/apollo/apollo_p2.mk
	PRODUCT_PROPERTY_OVERRIDES += \
		persist.sys.locale=zh-CN

persist.sys.country 以及 persist.sys.language 属性

--- a/device/softwinner/apollo/apollo_p2.mk
+++ b/device/softwinner/apollo/apollo_p2.mk
@@ -32,8 +32,8 @@ PRODUCT_PACKAGES += FT618

 PRODUCT_SYSTEM_DEFAULT_PROPERTIES += \
     persist.sys.timezone=Asia/Shanghai \
-    persist.sys.country=US \
-    persist.sys.language=en
+    persist.sys.country=CN \
+    persist.sys.language=zh

PRODUCT_LOCALES 配置

$ vim build/target/product/full_base.mk
	PRODUCT_LOCALES := en_US
选项
描述

en_US

英文

zh_CN

中文

locale 获取优先级 frameworks/base/core/jni/AndroidRuntime.cpp

/*
 * Read the persistent locale. Inspects the following system properties
 * (in order) and returns the first non-empty property in the list :
 *
 * (1) persist.sys.locale
 * (2) persist.sys.language/country/localevar (country and localevar are
 * inspected iff. language is non-empty.
 * (3) ro.product.locale
 * (4) ro.product.locale.language/region
 *
 * Note that we need to inspect persist.sys.language/country/localevar to
 * preserve language settings for devices that are upgrading from Lollipop
 * to M. The same goes for ro.product.locale.language/region as well.
 */
const std::string readLocale()
{
    const std::string locale = GetProperty("persist.sys.locale", "");
    if (!locale.empty()) {
        return locale;
    }

    const std::string language = GetProperty("persist.sys.language", "");
    if (!language.empty()) {
        const std::string country = GetProperty("persist.sys.country", "");
        const std::string variant = GetProperty("persist.sys.localevar", "");

        std::string out = language;
        if (!country.empty()) {
            out = out + "-" + country;
        }

        if (!variant.empty()) {
            out = out + "-" + variant;
        }

        return out;
    }

    const std::string productLocale = GetProperty("ro.product.locale", "");
    if (!productLocale.empty()) {
        return productLocale;
    }

    // If persist.sys.locale and ro.product.locale are missing,
    // construct a locale value from the individual locale components.
    const std::string productLanguage = GetProperty("ro.product.locale.language", "en");
    const std::string productRegion = GetProperty("ro.product.locale.region", "US");

    return productLanguage + "-" + productRegion;
}

内置第三方 APP

比如新增 test.apk

h618-android12.0\vendor\aw\public\prebuild\apk 放你的apk和Android.bp

Android.mk 方式

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
#可以为user、eng、tests、optional,optional代表在任何版本下都编译
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)

#可以为testkey、platform、shared、media、PRESIGNED(使用原签名),platform代表为系统应用
LOCAL_CERTIFICATE := PRESIGNED

LOCAL_ENFORCE_USES_LIBRARIES := false
LOCAL_DEX_PREOPT := false

LOCAL_MODULE := test

LOCAL_SRC_FILES := $(LOCAL_MODULE).apk

include $(BUILD_PREBUILT)

Android.bp 方式

android_app_import {
    name: "test",
    apk: "test.apk",

    //presigned: true,
    certificate: "platform",  //platform表示系统应用,可设置
    dex_preopt: {
        enabled: true,
    },

    privileged: true, //指应用是特权应用 具有高权限
    //product_specific: true,
    //proprietary: true,
    enforce_uses_libs: false,
}

在/vendor/aw/homlet/homlet.mk加入编译

PRODUCT_PACKAGES += \
       test

开机自启动 APP

Launcher方式启动

此方式替换桌面,返回 HOME 为 替换后的APP

要让 APP 作为 Launcher 开机自启动,需要在 AndroidManifest.xml 中添加两个 category

<activity android:name=".MainActivity">
    <intent-filter>
		<category android:name="android.intent.category.HOME"/>
		<category android:name="android.intent.category.DEFAULT"/>
	</intent-filter>
</activity>

h618 作为Launcher 由于权限限制会出现APP问题,需要针对添加权限, 参考 [APP特殊权限问题](## APP特殊权限问题)

没有桌面属性缺失问题,需要添加 上面两个 category

image-20241101094329876

预置时替换原生桌面,需要添加覆盖属性

Android.bp 方式

#overrides覆盖应用列表 #覆盖其他应用:overrides 列表中的每个条目都是一个应用的名称,这些应用如果存在,将会被当前应用覆盖。这意味着如果设备上已经安装了列表中的任何一个启动器应用,"LauncherJingWei" 将会优先启动并接管启动器的功能。 #优先级:通过这种方式,你可以确保你的应用在某些情况下优先于其他应用被加载和使用。这对于预装应用特别有用,因为它们通常需要替代系统默认的应用。

   overrides: [
        "Launcher2",
        "Launcher3",
        "Launcher3QuickStep",
        "Launcher3QuickStepGo",
    ],

Android.mk 方式

LOCAL_OVERRIDES_PACKAGES := Launcher2 Launcher3 Launcher3QuickStep Launcher3QuickStepGo

后台调用方式

此方式通过接收开机完成广播调起APK,可返回原本桌面

通过接收开机广播完成后,启动APP

1、修改增加 APP 的权限以及广播接收 AndroidManifest.xml

<uses-permission android:name="android.permission.START_ACTIVITIES_FROM_BACKGROUND" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

<application
        <receiver
            android:name=".MyReceiver"
            android:enabled="true"
            android:exported="true">
            <intent-filter android:priority="1000">
                <action android:name="android.intent.action.BOOT_COMPLETED"></action>
            </intent-filter>
        </receiver>
</application>

2、增加广播接收 MyReceiver.java

package com.example.myapplication;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;

public class MyReceiver extends BroadcastReceiver {
    public MyReceiver() {
    }

    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getAction().equals("android.intent.action.BOOT_COMPLETED")) {
            Intent i = new Intent(context, MainActivity.class);
            i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(i);
            Log.i("kickpi", "onReceive: start app !!!");
        }
    }
}

3、预装app 到 /system/priv-app/

  • 方式一,编译预装到源码,参考 [内置第三方APP](# 6. 内置第三方APP)

  • 方式二,push 方式预装

    adb root; adb remount;
    adb push ./app /system/priv-app/

h618 预装到 priv-app 由于权限限制会出现APP问题,需要针对添加权限, 参考 [APP特殊权限问题](## APP特殊权限问题)

APK priv-app push 替换

adb root; adb remount;  // 进行root 可以修改只读分区
adb push (你APK的路径) /system/priv-app/
adb reboot // 重启,android 会检索  /system/priv-app/ 的apk进行安装

卸载原桌面app

pm uninstall --user 0 com.android.tv.launcher

APP签名文件

签名文件路径如下

build/target/product/security/platform.pk8
build/target/product/security/platform.x509.pem
out/host/linux-x86/framework/signak.jar

APP特殊权限问题

目前桌面级APP是特殊应用,如果添加特殊权限,可能会出现系统无法起来问题,需要抓取APP相关log日志

# logcat | grep com.example.myapplication3(Androidapk的包名)
09-14 10:36:06.662  3826  3826 W PackageManager: Privileged permission android.permission.INSTALL_PACKAGES for package com.example.myapplication3 (/system/priv-app/LauncherJingWei) not in privapp-permissions allowlist
09-14 10:36:08.437  3826  3826 W PackageManager: Privileged permission android.permission.INSTALL_PACKAGES for package com.example.myapplication3 (/system/priv-app/LauncherJingWei) not in privapp-permissions allowlist

根据log信息添加权限

SDK
	修改 frameworks/base/data/etc/privapp-permissions-platform.xml
	重新编译烧录

主板上
	/etc/permissions/privapp-permissions-platform.xml

根据 log 修改 android.permission.INSTALL_PACKAGES 内容如下,其他报错类似参考以下添加:

--- a/frameworks/base/data/etc/privapp-permissions-platform.xml
+++ b/frameworks/base/data/etc/privapp-permissions-platform.xml
@@ -550,4 +550,8 @@ applications that come with the platform
     <privapp-permissions package="com.android.calllogbackup">
         <permission name="com.android.voicemail.permission.READ_VOICEMAIL"/>
     </privapp-permissions>
+
+    <privapp-permissions package="com.example.myapplication3">
+        <permission name="android.permission.INSTALL_PACKAGES"/>
+    </privapp-permissions>

全编替换不生效问题

由于惰性编译,一些编译目标或依赖直接替换文件,在编译时不会拷贝生效

需要先手动清除,再进行编译

source build/envsetup.sh
lunch apollo_p2-userdebug
make installclean -j32
./build.sh

HDMI 固定输出分辨率

HDMI TX

hdmi tx 属性结点

# ls /sys/class/hdmi/hdmi/attr
avmute          dvi_mode   hdcp_enable  hpd_mask   phy_write  scdc_write
cec_dump        edid       hdcp_status  hpi_read   read       set_ddc
cec_enable      edid_test  hdcp_type    hpi_write  reg_dump   write
cec_simulation  esm_dump   hdmi_sink    phy_power  rxsense
debug           hdcp_dump  hdmi_source  phy_read   scdc_read

ADB 功能

adb连接

image-20250312140738317

板卡使用type-c线连接电脑,等板卡蓝灯闪烁时查看系统设备管理器是否识到是安卓设备,如果识别到的设备如图所示则需手动安装驱动

image-20250226152046272

手动安装驱动

370849870429aae4906079eb686ee326
image-20250226152541205
image-20250226152555933
image-20250226152618854
image-20250226152635425
image-20250226152643858
image-20250226152654260

win键+R打开“运行” 输入cmd打开命令行

image-20250226152824342

命令行中输入adb shell即可连接

系统若没有adb命令支持可自行参考安装Windows 10 安装 ADB (Android Debug Bridge,Android 调试桥)-CSDN博客

image-20250226152859458

adb offline 问题

$ adb devices
List of devices attached
6c00107150d147e1d52     offline

reconnect 即可

$ adb reconnect
reconnecting 6c00107150d147e1d52 [offline]

网络ADB

网口ADB需要先adb启动5555端口服务后

PS C:\Users\16708\Desktop> adb tcpip 5555
PS C:\Users\16708\Desktop> adb connect 192.168.77.170
connected to 192.168.77.170:5555
PS C:\Users\16708\Desktop> adb devices
List of devices attached
7c001075a313c7c1c12     device
192.168.77.170:5555     device

PS C:\Users\16708\Desktop> adb -s 192.168.77.170:5555 shell
apollo-p2:/ $ su

开机默认启动5555端口

需要通过USB adb操作

 adb root
 adb remount
 adb pull /system/build.prop
 //在build.prop中加入
 //添加这一行
 service.adb.tcp.port=5555
 //替换进入
 adb push .\build.prop /system/build.prop
 adb reboot

ADB投屏

下载工具网盘路径

h618_data\5-DevelopmentTools开发工具\ADB Screen Cast 投屏

image-20250303103950558
image-20250303104027819

旋转功能

支持使用adb命令进行旋转

// 正常显示
adb shell settings put system user_rotation 0

// 90°
adb shell settings put system user_rotation 1

// 180°
adb shell settings put system user_rotation 2

// 270°
adb shell settings put system user_rotation 3

Last updated