{"id":13487156,"url":"https://github.com/didi/chameleon","last_synced_at":"2025-06-15T17:11:18.804Z","repository":{"id":38418108,"uuid":"166419150","full_name":"didi/chameleon","owner":"didi","description":"🦎 一套代码运行多端，一端所见即多端所见","archived":false,"fork":false,"pushed_at":"2023-01-07T22:16:40.000Z","size":132324,"stargazers_count":9022,"open_issues_count":276,"forks_count":694,"subscribers_count":234,"default_branch":"master","last_synced_at":"2024-04-14T13:44:07.612Z","etag":null,"topics":["android","chameleon","cml","ios","miniprogram","mobile","vue","weex"],"latest_commit_sha":null,"homepage":"http://cml.didi.cn/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/didi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-18T14:41:35.000Z","updated_at":"2024-04-12T02:46:29.000Z","dependencies_parsed_at":"2023-02-08T02:46:46.526Z","dependency_job_id":null,"html_url":"https://github.com/didi/chameleon","commit_stats":null,"previous_names":[],"tags_count":86,"template":false,"template_full_name":null,"purl":"pkg:github/didi/chameleon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/didi%2Fchameleon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/didi%2Fchameleon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/didi%2Fchameleon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/didi%2Fchameleon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/didi","download_url":"https://codeload.github.com/didi/chameleon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/didi%2Fchameleon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260016055,"owners_count":22946321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","chameleon","cml","ios","miniprogram","mobile","vue","weex"],"created_at":"2024-07-31T18:00:56.024Z","updated_at":"2025-06-15T17:11:18.780Z","avatar_url":"https://github.com/didi.png","language":"JavaScript","readme":"\n\nChameleon [![Build Status](https://www.travis-ci.org/didi/chameleon.svg?branch=master)](https://www.travis-ci.org/didi/chameleon) [![license](https://img.shields.io/npm/l/chameleon-tool.svg?registry_uri=https%3A%2F%2Fregistry.npmjs.com\u0026style=popout-square)](https://www.npmjs.com/package/chameleon-tool) [![version](https://img.shields.io/npm/v/chameleon-tool.svg?style=flat)](https://www.npmjs.com/package/chameleon-tool)\n\n**Chameleon**/kəˈmiːlɪən/，简写`CML`，中文名`卡梅龙`；中文意思`变色龙`，意味着就像变色龙一样能适应不同环境的跨端整体解决方案。\n\n[English Introduction](https://github.com/didi/chameleon/blob/gh-pages/doc/quick_start/readme-en.md) | 中文介绍\n\n## 文档\n[新官网文档](http://cml.didi.cn/)\n\n[CML.JS.org](https://cml.js.org)\n\n- [安装](https://CML.JS.org/doc/quick_start/quick_start.html)\n- [快速上手](https://CML.JS.org/doc/quick_start/quick_start.html)\n- [API 文档](https://CML.JS.org/doc/api/api.html)\n- [组件文档](https://CML.JS.org/doc/component/component.html)\n- [资源汇总 💰awesome-cml](https://github.com/chameleon-team/awesome-cml)：依赖库、demo、完整应用示例、学习资源\n- [后续规划](https://github.com/didi/chameleon/wiki/%E5%90%8E%E6%9C%9F%E8%A7%84%E5%88%92)\n- [五分钟上手视频教程](https://mp.weixin.qq.com/s/3NY_pbqDVnbQSYQG_D2qiA)\n- [青桔单车 chameleon 跨平台实践分享](https://mp.weixin.qq.com/s/N8PpxRHHtlIHVlemQ1Gepg)\n- [谁在使用？](https://github.com/didi/chameleon/issues/131)\n\n## 仓库更新说明\n\n本仓库仅包含编译时代码，全部开源代码参见：https://github.com/chameleon-team\n\nmaster为稳定版本，除了紧急 bug 修复，每份代码提交都有很严格的发布流程规范，会先在分支经历一段时间灰度期，确认稳定可用后才会合并到 master，\n[进行中的项目分支介绍](https://github.com/didi/chameleon/wiki/%E8%BF%9B%E8%A1%8C%E4%B8%AD%E7%9A%84%E9%A1%B9%E7%9B%AE)\n\n## CML 即 多端\n支持平台：**web、微信小程序、支付宝小程序、百度小程序、[android(weex)](https://github.com/chameleon-team/chameleon-sdk-android)、[ios(weex)](https://github.com/chameleon-team/chameleon-sdk-ios)、qq 小程序、[字节跳动小程序](https://cml.js.org/doc/example/tt_miniapp.html)、[快应用](https://cml.js.org/doc/example/quickapp_miniapp.html)、持续更新中**\n\n**一端所见即多端所见**——多端高度一致，无需关注各端文档。\n\n\u003e 基于多态协议不影响各端差异化灵活性\n\u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\n\u003cimg src=\"https://cml.js.org/doc/assets/efficient.gif\" width=\"400px\"/\u003e\n\u003c/a\u003e\n\n\n|                                                                 web                                                                  |                                                             微信小程序                                                             |                                                              native-weex                                                              |                                                               百度小程序                                                               |                                                              支付宝小程序                                                              |\n| :----------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------: |\n| \u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\u003cimg src=\"https://cmljs.org/cml-demo/preview/web-1.jpg\" width=\"200px\"/\u003e \u003c/a\u003e | \u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\u003cimg src=\"https://cmljs.org/cml-demo/preview/wx-1.jpg\" width=\"200px\"/\u003e\u003c/a\u003e | \u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\u003cimg src=\"https://cmljs.org/cml-demo/preview/weex-1.jpg\" width=\"200px\"/\u003e \u003c/a\u003e | \u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\u003cimg src=\"https://cmljs.org/cml-demo/preview/baidu-1.png\" width=\"200px\"/\u003e \u003c/a\u003e | \u003ca href=\"https://github.com/beatles-chameleon/cml-demo\"\u003e\u003cimg src=\"https://cmljs.org/cml-demo/preview/alipay-1.png\" width=\"200px\"/\u003e\u003c/a\u003e |\n\n## 背景\n\n研发同学在端内既追求 h5 的灵活性，也要追求性能趋近于原生。\n面对入口扩张，App 客户端、微信小程序、支付宝小程序、百度小程序、Android 厂商联盟快应用、其他类小程序，单一功能在各平台都要重复实现，开发和维护成本成倍增加。迫切需要维护一套代码可以构建多入口的解决方案，滴滴跨端解决方案 Chameleon 终于发布。真正专注于让一套代码运行多端。\n\n## 设计理念\n\n软件架构设计里面最基础的概念“拆分”和“合并”，拆分的意义是“分而治之”，将复杂问题拆分成单一问题解决，比如后端业务系统的”微服务化“设计；“合并”的意义是将同样的业务需求抽象收敛到一块，达成高效率高质量的目的，例如后端业务系统中的“中台服务”设计。\n\n而 Chameleon 属于后者，通过定义统一的语言框架+[统一多态协议](http://cml.didi.cn/docs/poly.html)，从多端（对应多个独立服务）业务中抽离出自成体系、连续性强、可维护强的“前端中台服务”。\n\n\u003cimg src=\"https://cml.js.org/doc/assets/chameleon-idea.png\" width=\"400px\"/\u003e\n\n### 跨端目标\n\n虽然不同各端环境千变万化，但万变不离其宗的是 MVVM 架构思想，**Chameleon 目标是让 MVVM 跨端环境大统一**。\n\n![跨端目标](https://cml.js.org/doc/assets/mvvm4.png)\n\n\n## 开发语言\n代码示例\n```html\n\u003ctemplate\u003e\n  \u003cview\u003e\n    \u003ctext\u003e{{title}}\u003c/text\u003e\u003ctext\u003e{{reversedTitle}}\u003c/text\u003e\n  \u003c/view\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\nclass Index  {\n  data = {\n    title: \"chameleon\"\n  }\n  computed = {\n    reversedTitle: function () {\n      return this.title.split('').reverse().join('')\n    }\n  }\n  mounted() {}\n  destroyed() {}\n}\nexport default new Index();\n\u003c/script\u003e\n```\n从事过网页编程的人知道，网页编程采用的是 HTML + CSS + JS 这样的组合，同样道理，chameleon 中采用的是 CML + CMSS + JS。\n\n[JS](https://CML.JS.org/doc/logic/logic.html)语法用于处理页面的逻辑层，与普通网页编程相比，本项目目标定义标准 MVVM 框架，拥有完整的生命周期，watch，computed，数据双向绑定等优秀的特性，能够快速提高开发速度、降低维护成本。\n\n[CML](https://CML.JS.org/doc/view/cml.html)（Chameleon Markup Language）用于描述页面的结构，我们知道 HTML 是有一套标准的语义化标签，例如文本是`\u003cspan\u003e` 按钮是`\u003cbutton\u003e`。CML 同样具有一套标准的标签，我们将标签定义为`组件`，CML 为用户提供了一系列[组件](https://CML.JS.org/doc/component/base/base.html)。同时 CML 中还支持\u003cb\u003e模板语法\u003c/b\u003e，例如条件渲染、列表渲染，数据绑定等等。同时，CML 支持使用[类 VUE 语法](https://CML.JS.org/doc/view/vue.html)，让你更快入手。\n\n[CMSS](https://CML.JS.org/doc/view/cmss.html)(Chameleon Style Sheets)用于描述 CML 页面结构的样式语言，其具有大部分 CSS 的特性，并且还可以支持各种 css 的预处语言`less stylus`。\n\nCML 采用与 Vue 一致的组件化方案、单文件组织方式、生命周期，同时数据响应能力对齐 Vue，数据管理能力对齐 Vuex，非常方便开发者上手、维护。\n\n通过以上对于开发语言的介绍，相信你看到只要是有过网页编程知识的人都可以快速的上手chameleon的开发。\n\n## 多端高度一致\n\n深入到编程语言维度保障一致性，包括框架、生命周期、内置组件、事件通信、路由、界面布局、界面单位、组件作用域、组件通信等高度统一\n\n## 丰富的组件\n\n在用 CML 写页面时，chameleon 提供了[丰富的组件](https://CML.JS.org/doc/component/component.html)供开发者使用，内置的有`button switch radio checkbox`等组件，扩展的有`c-picker c-dialog c-loading`等等,覆盖了开发工作中常用的组件。\n\n## 丰富的 API\n\n为了方便开发者的高效开发，chameleon 提供了[丰富的 API 库](https://CML.JS.org/doc/api/api.html),发布为 npm 包`chameleon-api`，里面包括了网络请求、数据存储、地理位置、系统信息、动画等方法。\n\n## 自由定制 API 和组件\n\n基于强大的[多态协议](https://CML.JS.org/doc/framework/polymorphism/intro.html)，可自由扩展任意 API 和组件，不强依赖框架的更新。各端原始项目中已积累大量组件，也能直接引入到跨端项目中使用。\n\n基于强大的[多态协议](https://CML.JS.org/doc/framework/polymorphism/intro.html)，充分隔离各端差异化实现，轻松维护一套代码实现跨多端\n\n## [规范校验](http://cml.didi.cn/docs/introduction.html#%E6%99%BA%E8%83%BD%E8%A7%84%E8%8C%83%E6%A0%A1%E9%AA%8C)\n\n代码规范校验，当出现不符合规范要求的代码时，编辑器会展示智能提示，不用挨个调试各端代码，同时命令行启动窗口也会提示代码的错误位置。\n\n## 渐进式跨端\n\n既想一套代码运行多端，又不用大刀阔斧的重构项目？不仅可以用 cml 开发页面，也可以将多端重用组件用 cml 开发，直接在原有项目里面调用。\n\n## 先进前端开发体验\n\nChameleon 不仅仅是跨端解决方案。基于优秀的前端打包工具 Webpack，吸收了业内多年来积累的最有用的工程化设计，提供了前端基础开发脚手架命令工具，帮助端开发者从开发、联调、测试、上线等全流程高效的完成业务开发。\n\n## 联系我们\n\n[ChameleonCore@didiglobal.com](mailto:ChameleonCore@didiglobal.com)\n\n## [Beatles Chameleon 团队](https://github.com/chameleon-team)\n\n负责人：Conan\n\n内部成员：透心凉、Sgoddon、动机不纯、Jalon、Jack、卡尺哈哈、change、Observer、Kevin、guoqingSmile、Mr.MY、JiM、lzc、名字待定、朱智恒、亭、龚磊、w55、小龙、不懂小彬、荣景超\n\n## 特别鸣谢\n[![zheyizhifeng](https://avatars3.githubusercontent.com/u/9592849?s=100\u0026v=4)](https://github.com/zheyizhifeng)|[(头像空)](https://github.com/whuhenrylee)|[![broven](https://avatars0.githubusercontent.com/u/12854613?s=100\u0026v=4)](https://github.com/broven/)|[(头像空)](https://github.com/Jeany/)\n:---:|:---:|:---:|:---:\n[zheyizhifeng（快应用）](https://github.com/zheyizhifeng)|[whuhenrylee（快应用）](https://github.com/whuhenrylee)|[broven（阿里影业）](https://github.com/broven/)|[Jeany（芒果 TV)](https://github.com/yaxiji/)\n\n## 贡献者们\n快应用官方研发团队、luyixin、z-mirror、夏夜焰火（百度）\n[kingsleydon](https://github.com/kingsleydon)\n\n## 微信 \u0026 QQ 交流群\n\n**微信**\u003cbr /\u003e\n\u003cimg width=\"150px\" src=\"https://CML.JS.org/doc/assets/wx-qr-code.png\" /\u003e\n\n\u003cbr /\u003e\n\n**QQ**\u003cbr /\u003e\n\u003cimg width=\"150px\" src=\"https://cmljs.org/doc/assets/qq2-qrcode.JPG\" /\u003e\n\n\n## 协议\n\nApache-2.0 license\n\nChameleon 基于 Apache-2.0 协议进行分发和使用，更多信息参见[协议文件](./LICENSE)。\n\n## 友情链接\n\n[DoraemonKit](https://github.com/didi/DoraemonKit) /'dɔ:ra:'emɔn/，简称DoKit， 一款功能齐全的客户端（ iOS 、Android、微信小程序 ）研发助手，你值得拥有。\n\n[Mand Mobile](https://github.com/didi/mand-mobile) 一款优秀的面向金融场景的 移动端UI组件库。\n\n\n[Cube-UI](https://github.com/didi/cube-ui)  基于 Vue.js 实现的精致移动端组件库。\n","funding_links":[],"categories":["JavaScript","工具","UI模板","2. JavaScript 框架汇总","Projects List","目录"],"sub_categories":["3、小程序模板","Chameleon官方仓库"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdidi%2Fchameleon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdidi%2Fchameleon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdidi%2Fchameleon/lists"}