# @genexus/gemini 中文文档

规范地址：https://npmcn.com/package/%40genexus/gemini/

版本：2\.0\.1
npm 元数据更新时间：2026-02-03T15:07:44.032Z
中文译文更新时间：2026-11-16T03:23:04.698Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40genexus/gemini
原文对照：https://npmcn.com/package/%40genexus/gemini/?lang=original

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

- 包体积（解压后）：13.2 MB，1965 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：@genexus/chameleon-controls-library \>=6\.0\.0-next\.1
- 首次发布：2019-11-07T16:53:24.249Z
- 最新版本发布：2024-10-01T18:41:43.441Z
- 近 30 天下载量：2745（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：635（近 12 个月 0 个）

## 中文简介

双子座设计系统

## 安装

```sh
npm install @genexus/gemini
```

也可以使用：`pnpm add @genexus/gemini`、`yarn add @genexus/gemini`、`bun add @genexus/gemini`

## README

![Built With Stencil](https://img.shields.io/badge/-Built%20With%20Stencil-16161d.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDE5LjIuMSwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiBzdHlsZT0iZW5hYmxlLWJhY2tncm91bmQ6bmV3IDAgMCA1MTIgNTEyOyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI%2BCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyI%2BCgkuc3Qwe2ZpbGw6I0ZGRkZGRjt9Cjwvc3R5bGU%2BCjxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik00MjQuNywzNzMuOWMwLDM3LjYtNTUuMSw2OC42LTkyLjcsNjguNkgxODAuNGMtMzcuOSwwLTkyLjctMzAuNy05Mi43LTY4LjZ2LTMuNmgzMzYuOVYzNzMuOXoiLz4KPHBhdGggY2xhc3M9InN0MCIgZD0iTTQyNC43LDI5Mi4xSDE4MC40Yy0zNy42LDAtOTIuNy0zMS05Mi43LTY4LjZ2LTMuNkgzMzJjMzcuNiwwLDkyLjcsMzEsOTIuNyw2OC42VjI5Mi4xeiIvPgo8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNDI0LjcsMTQxLjdIODcuN3YtMy42YzAtMzcuNiw1NC44LTY4LjYsOTIuNy02OC42SDMzMmMzNy45LDAsOTIuNywzMC43LDkyLjcsNjguNlYxNDEuN3oiLz4KPC9zdmc%2BCg%3D%3D&colorA=16161d&style=flat-square) [![CircleCI](https://circleci.com/gh/genexuslabs/gemini.svg?style=svg&circle-token=b1db9c6dddcdbd45eb9e9dcf24e888f9c0d956b1)](https://circleci.com/gh/genexuslabs/gemini) [![Netlify Status](https://api.netlify.com/api/v1/badges/7935c6df-a07b-4eb7-bd7e-0ddc9f1da9f6/deploy-status)](https://app.netlify.com/sites/gx-gemini/deploys)

# 双子座设计系统

* * *

## \* 双子座不再开发

此控制库已不再在开发中. 为了开发GeneXus扩展 **[变色龙控制库](https://github.com/genexuslabs/chameleon-controls-library)** 正在连同 **[汞设计系统](https://github.com/genexuslabs/design-systems/tree/main/packages/mercury)**。 。 。 .

* * *

## 关于双子座

GeneXus IDEs的设计系统(GeneXus M和GeneXus for Windows). [给](https://share.goabstract.com/5d9855b3-43b6-4815-9c65-360e405a25c8) 您可以找到调色板、打字、样式和组件的概览。 你可以尝试设计系统组件 [这里](https://gx-gemini.netlify.com/)。 。 。 .

## 开始

```bash
npm install
npm start
```

## 运行测试

要运行自定义元素的单元测试, 运行:

```bash
npm test
```

## 生产大楼

为了构建生产设计,运行:

```bash
npm run build
```

## 使用这个设计系统

### 脚本标签

-   设置类似此的脚本标签 `<script src='https://unpkg.com/@genexus/gemini/dist/gemini.js'></script>` 在索引.html的首页
-   设置类似此的链接标签 `<link href="https://unpkg.com/@genexus/gemini/dist/gemini/gemini.css" rel="stylesheet" />` 在索引.html的首页
-   然后可以开始使用您模板中的布局编辑器,JSX,html等.

### 节点模块

-   运行 `npm install @genexus/gemini --save`
-   设置类似此的脚本标签 `<script src='node_modules/@genexus/gemini/dist/gemini.js'></script>` 在索引.html的首页
-   设置类似此的链接标签 `<link href="node_modules/@genexus/gemini/dist/gemini/gemini.css" rel="stylesheet" />` 在索引.html的首页
-   然后可以开始使用您模板中的布局编辑器,JSX,html等.

### 黑暗主题

-   简单添加 `dark` 类到 `html` 标签.

### 右到左读方向

-   双子座还用"右向左"来读取方向语言. 刚刚设置 `dir` 属性值到 `rtl` 编辑 `html` 标签.

## 与 Stencil 使用此设计系统

### 安装双子座

1.  `npm install @genexus/gemini --save`
2.  为 Stencil 安装 SAS 插件 : `npm install @stencil/sass --save-dev`
3.  编辑 `stencil.config.ts` 已解释 [这里](https://github.com/ionic-team/stencil-sass)。 。 。 .
4.  添加 `globalStyle` 内 `stencil.config.ts` 指点 `src/globals/global.scss`

这个 `stencil.config.ts` 文件应该看起来像这样:

```
import { Config } from "@stencil/core";
import { sass } from "@stencil/sass";

export const config: Config = {
   namespace: "project-name",
   outputTargets: [
      {
         type: "dist",
         esmLoaderPath: "../loader"
      },
      {
         type: "docs-readme"
      },
      {
         type: "www",
         serviceWorker: null
      }
   ],
   globalStyle: "src/globals/global.scss",
   plugins: [sass()]
};
```

5.  创建 `global.scss` 文件编号 `src/globals`。 。 。 .
6.  向内部双子座样式表添加导入 `global.scss`数字 :

`@import "../../node_modules/@genexus/gemini/dist/gemini/gemini.css";`

7.  在内部添加导入到双子星 JavaScript 文件 `src/index.ts`数字 : `import "@genexus/gemini";`
8.  在第四点定义了全局Style后, 您的组件库将输出一个 CSS 文件 。 您必须将此 CSS 文件包含在您的 `src/index.html` 文档。 样式表的名称与工程名称相同 : `<link rel="stylesheet" href="/build/project-name.css" />`
9.  没问题! 您现在可以消费双子座的网络组件并使用其CSS变量: `<gxg-button>Button</gxg-button>`

## 作者数

见 [捐助者](https://github.com/genexuslabs/gemini/contributors) 参与该项目的人.

## 许可证

```
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

## 常见问题

### @genexus/gemini 是什么？

双子座设计系统

### 如何安装 @genexus/gemini？

在项目目录运行 npm install @genexus/gemini，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@genexus/chameleon-controls-library（\>=6\.0\.0-next\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @genexus/gemini 支持 TypeScript 吗？

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

### @genexus/gemini 支持 ESM 还是 CommonJS？

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

### @genexus/gemini 可以商用吗？

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

### @genexus/gemini 的下载量有多少？

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

### @genexus/gemini 还在维护吗？

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

