@capgo/home-indicator

中文文档
7.1.3发布于 2025/08/14MITTypeScriptESM + CJS零依赖近 30 天下载 5438

在 Capacitor app 中隐藏并显示家用按钮指示器

此软件包已被标记为弃用

use @capgo/capacitor-home-indicator instead

中文使用文档
文档目录9 节
  1. QQ 与 Capgo 为您的 App 即时更新
  2. 缺少一个功能? 我们会为你构建插件 。 @ @ info
  3. 安装
  4. API 密码
  5. 隐藏( c)
  6. 显示 ()
  7. 隐藏( H)
  8. 获取 PluginVersion ()
  9. CSS 变量

@ capgo/ 家庭指标

Capgo - Instant updates for capacitor

在 Capacitor app 中隐藏并显示家用按钮指示器

机器人

为了能隐藏Android的家用指示器,你需要 更新您的 MainActivity.java 要添加以下代码的文件 :

// ...

import android.os.Build;
import android.os.Bundle;

import com.getcapacitor.BridgeActivity;

public class MainActivity extends BridgeActivity {


    void fixSafeArea() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            getWindow().setDecorFitsSystemWindows(false);
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        fixSafeArea();
    }
    // on resume
    @Override
    public void onResume() {
        super.onResume();
        fixSafeArea();
    }

    // on pause
    @Override
    public void onPause() {
        super.onPause();
        fixSafeArea();
    }
}

而更新样式为.xml以添加以下代码:

        <item name="android:statusBarColor">
            @android:color/transparent
        </item>

安装

npm install @capgo/home-indicator
npx cap sync

API 密码

隐藏( c)

hide() => Promise<void>

隐藏家用指示器.

自: 0.0.1 资源


显示 ()

show() => Promise<void>

显示出家道指示.

自: 0.0.1 资源


隐藏( H)

isHidden() => Promise<{ hidden: boolean; }>

获得家用指示器状态.

回返情况: Promise<{ hidden: boolean; }>

自: 0.0.1 资源


获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本

回返情况: Promise<{ version: string; }>


CSS 变量

你用得着 --safe-area-inset-bottom 以确保您的内容不被家用指示器隐藏 此变量由 Android 插件注入 . 如果你在机器人上设置真正的全屏模式,那就有用了. 改为:

getWindow().setDecorFitsSystemWindows(false);

贷项

此插件最初是为 Kick.com (英语) 以 队长

版本与发布记录

@capgo/home-indicator 共发布 108 个版本,首次发布于 2023/07/04;过去 12 个月发布了 0 个版本。

版本发布日期距今
7.1.3latest2025/08/141.2 年前
6.0.752025/02/031.8 年前
6.0.742025/01/271.8 年前
6.0.732025/01/231.8 年前
6.0.722025/01/061.8 年前
6.0.712024/12/231.9 年前

关于 @capgo/home-indicator 的常见问题

@capgo/home-indicator 是什么?

在 Capacitor app 中隐藏并显示家用按钮指示器注意:该包已被作者标记为弃用——use @capgo/capacitor-home-indicator instead

如何安装 @capgo/home-indicator?

在项目目录运行 npm install @capgo/home-indicator,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=7.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/home-indicator 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capgo/home-indicator 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/home-indicator 可以商用吗?

@capgo/home-indicator 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capgo/home-indicator 的下载量有多少?

根据 npm 官方下载统计,@capgo/home-indicator 在 2026/10/09 – 2026/11/07 这 30 天内被下载 5,438 次,日均约 181 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capgo/home-indicator 还在维护吗?

最新版本 7.1.3 发布于 2025/08/14(1.2 年前);至今共发布 108 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/07/04。作者已将其标记为弃用,新项目建议寻找替代方案。