@easy-smart-app-banner/core

中文文档
3.0.0发布于 2026/10/21MITTypeScriptES Module构建来源已验证近 30 天下载 4794

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

中文使用文档
文档目录12 节
  1. 特征
  2. 安装
  3. 配置
  4. 萨法里支助
  5. 高级使用
  6. 平台特定覆盖
  7. SCSS/Sass变量
  8. 平台特定插件
  9. 测试您的用户代理( UA) 字符串是否有效
  10. 发展
  11. 发布版本
  12. 许可证

简单智能 App Blanner

NPM version TypeScript

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

这不是每个人的。 大部分人应该更喜欢 巴布亚新几内亚 办法。 然而,如果你需要一个"简单"的旗帜, 将转向一个 本地语言 移动应用程序然后继续读取.

关于Safari的支持,请参见 萨法里支助。 。 。 . 关于iOS和Safari的具体细节改为: 这里。 。 。 . 对Android来说也是 这里。 。 。 .

特征

  • 字体支持
  • 独立/无框架
  • 小点! 14.48 kB │ gzip: 4.43 kB │ map: 44.87 kB
  • 特定平台
    • iOS(非Safari)和Android用户代理的自定义横幅
    • Safari 特定配置 见 萨法里支助
  • 选项,根据需要使用SCSS/Sass变量配置横幅
  • 基于 Cookie 的解雇, 每个浏览器一次解雇

安装

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

配置

见 选项模式。 。 。 .

萨法里支助

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

高级使用

平台特定覆盖

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

具体关于iOS和Safari的具体细节改为: 这里。关于Android,参见 这里。 。 。 .

图标

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

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

价格

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

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

呼叫动作按钮标签

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

SCSS/Sass变量

样式可以使用提供的SCSS/Sass变量被覆盖. 见 变量。 。 。 .

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

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

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

平台特定插件

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

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

UA弦是一分钱一打, 这就是为什么在 verbose 模式(参见 配置),平台解析工具被曝光到窗口对象上,以便于测试. 在您的浏览器控制台中,

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

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

发展

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

别忘了跑 npm i来啊!

npm run build
npm run test

您可以在 软件包.json。 。 。 .

下一步是启动示范项目。 检查 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并撞倒演示.

许可证

麻省理工学院 许可证 2025-Present 阿尔伯特·弗格森

版本与发布记录

@easy-smart-app-banner/core 共发布 12 个版本,首次发布于 2025/05/08;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.0.0latest2026/10/2123 天前
2.1.12025/08/131.3 年前
2.1.02025/08/131.3 年前
2.0.02025/05/131.5 年前
1.0.72025/05/131.5 年前
1.0.62025/05/131.5 年前

关于 @easy-smart-app-banner/core 的常见问题

@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 和提交记录判断。