# @easy-smart-app-banner/core 中文文档

规范地址：https://npmcn.com/package/%40easy-smart-app-banner/core/

版本：3\.0\.0
npm 元数据更新时间：2026-10-21T06:50:44.777Z
中文译文更新时间：2026-11-13T03:51:33.373Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40easy-smart-app-banner/core
原文对照：https://npmcn.com/package/%40easy-smart-app-banner/core/?lang=original
项目主页：https://github.com/albert118/smart-app-banner/
源码仓库：https://github.com/albert118/smart-app-banner

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：90 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2025-05-08T15:41:44.656Z
- 最新版本发布：2026-10-21T06:50:44.374Z
- 近 30 天下载量：4794（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 1 个）

## 中文简介

基于Safari Apple经验推广移动应用程序安装的"简易智能App Banner". 包括对Safari的支持.

## 安装

```sh
npm install @easy-smart-app-banner/core
```

也可以使用：`pnpm add @easy-smart-app-banner/core`、`yarn add @easy-smart-app-banner/core`、`bun add @easy-smart-app-banner/core`

## README

# 简单智能 App Blanner

[![NPM version](https://img.shields.io/npm/v/@easy-smart-app-banner/core?logo=npm&color=e3e023)](https://www.npmjs.com/package/@easy-smart-app-banner/core) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)

基于Safari Apple经验推广移动应用程序安装的"简易智能App Banner".

> 这不是每个人的。 大部分人应该更喜欢 [巴布亚新几内亚](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps) 办法。 然而,如果你需要一个"简单"的旗帜, 将转向一个 _本地语言_ 移动应用程序然后继续读取.
> 
> 关于Safari的支持,请参见 [萨法里支助](https://npmcn.com/package/%40easy-smart-app-banner/core/#readme-safari-support)。 。 。 . 关于iOS和Safari的具体细节改为: [这里](https://developer.apple.com/documentation/webkit/promoting-apps-with-smart-app-banners)。 。 。 . 对Android来说也是 [这里](https://developer.chrome.com/blog/app-install-banners-native/)。 。 。 .

![](https://github.com/user-attachments/assets/de1387da-e51a-4851-9a64-345dbf0349ce)

## 特征

-   字体支持
-   独立/无框架
-   小点! `14.48 kB │ gzip: 4.43 kB │ map: 44.87 kB`
-   特定平台
    -   iOS(非Safari)和Android用户代理的自定义横幅
    -   ~Safari 特定配置~ 见 [萨法里支助](https://npmcn.com/package/%40easy-smart-app-banner/core/#readme-safari-support)
-   选项,根据需要使用SCSS/Sass变量配置横幅
-   基于 Cookie 的解雇, 每个浏览器一次解雇

* * *

## 安装

```sh
npm i -S @easy-smart-app-banner/core
```

## 配置

见 [选项模式](https://github.com/albert118/smart-app-banner/blob/master/src/models.ts)。 。 。 .

## 萨法里支助

由于无法通过图书馆/plugin/etc支持Safari, 通过您网站的静态元标记直接为本地的Safari智能应用程序旗下MUST提供支持。 Safari目前只支持在页面加载时立即解析此元数据,不会解析在此点后添加的任何元数据. 如果你想在本地加入Safari旗,然后阅读 [这里](https://developer.apple.com/documentation/webkit/promoting-apps-with-smart-app-banners)。 。 。 .

## 高级使用

### 平台特定覆盖

若干选项有特定平台覆盖。 在相关平台上运行时,这些选项优先于任何同等选项.

> 具体关于iOS和Safari的具体细节改为: [这里](https://developer.apple.com/documentation/webkit/promoting-apps-with-smart-app-banners)。关于Android,参见 [这里](https://developer.chrome.com/blog/app-install-banners-native/)。 。 。 .

#### 图标

单一图标是典型的,但可以配置出特定的图标.

```ts
{
    icon: '/assets/my-icon.jpeg',
    androidIcon: null,
    appleIcon: null,
}
```

#### 价格

价格标记线默认为FREE,同时为Android和iOS平台设置了特定平台默认.

```ts
{
    price: 'FREE',
    androidPrice: 'FREE - On the Google Play Store',
    applePrice: 'GET - On the App Store'
}
```

#### 呼叫动作按钮标签

```ts
{
    buttonLabel: 'View',
    androidButtonLabel: null,
    appleButtonLabel: null
}
```

### SCSS/Sass变量

样式可以使用提供的SCSS/Sass变量被覆盖. 见 [变量](https://github.com/albert118/smart-app-banner/blob/master/src/styles/variables.scss)。 。 。 .

您可以使用 `.scss` 文件代替,

```scss
@use '@easy-smart-app-banner/core/variables.scss' as *;

// overwrite as needed
$background-color: #000;
```

### 平台特定插件

> 找一个不在这里的平台? 推荐公关来补充!

-   [Vue 3 插件](https://github.com/albert118/smart-app-banner/tree/master/plugins/vue-plugin)

### 测试您的用户代理( UA) 字符串是否有效

UA弦是一分钱一打, 这就是为什么在 `verbose` 模式(参见 [配置](https://npmcn.com/package/%40easy-smart-app-banner/core/#readme-configuration)),平台解析工具被曝光到窗口对象上,以便于测试. 在您的浏览器控制台中,

```sh
const myUa = window.navigator.userAgent;
getCurrentPlatform(myUa)
```

这在调试可能不支持的已知 UA 字符串时特别有用. 如果您认为应该支持特定的普遍获得服务,请打开拉取请求!

## 发展

要开始,拉回放 运行一个建设和测试。 开发需要节点22或后期(即目前的LTS线路).

> 别忘了跑 `npm i`来啊!

```ts
npm run build
npm run test
```

您可以在 [软件包.json](https://npmcn.com/package/%40easy-smart-app-banner/core/package.json)。 。 。 .

下一步是启动示范项目。 检查 Vue 演示 [这里](https://github.com/albert118/smart-app-banner/tree/master/demo/vue)。 。 。 .

### 发布版本

Core和Vue插件与同版本一起发布.

1.  检查新分支 `release/major.minor.patch`
2.  在根中设置新版本 `package.json` 内 `plugins/vue-plugin/package.json` (单位:千美元)`npm version <version> --no-git-tag-version` 中,其中也更新了锁文件)
3.  视需要更新 README (跳出大小注释)
4.  发布分支并合并 PR
5.  运行 `Publish Packages to npmjs` 手动工作流程 `dry-run` 启用( 默认) 并检查其通过
6.  创建 GitHub 释放 `master` 带有标签 `vmajor.minor.patch`。工作流程对照两个软件包版本检查标签,然后发布核心,然后发布插件,两者都带有出处。 该插件是根据刚刚发布的核心版本及其 `@easy-smart-app-banner/core` 范围设定为已发布的软件包中的该版本.
7.  在后续PR中,设置插件的 `@easy-smart-app-banner/core` 范围到新版本 (`npm install @easy-smart-app-banner/core@^major.minor.patch` 内 `plugins/vue-plugin`并撞倒演示.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40easy-smart-app-banner/core/LICENSE) 许可证 2025-Present [阿尔伯特·弗格森](https://github.com/albert118/)

## 常见问题

### @easy-smart-app-banner/core 是什么？

基于Safari Apple经验推广移动应用程序安装的"简易智能App Banner"\. 包括对Safari的支持\.

### 如何安装 @easy-smart-app-banner/core？

在项目目录运行 npm install @easy-smart-app-banner/core，或使用 pnpm add / yarn add / bun add。

### @easy-smart-app-banner/core 支持 TypeScript 吗？

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

### @easy-smart-app-banner/core 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @easy-smart-app-banner/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @easy-smart-app-banner/core 可以商用吗？

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

### @easy-smart-app-banner/core 的下载量有多少？

根据 npm 官方下载统计，@easy-smart-app-banner/core 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,794 次，日均约 160 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @easy-smart-app-banner/core 还在维护吗？

最新版本 3\.0\.0 发布于 2026/10/21（23 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/05/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。