使用ng-metadata让Angular 1焕发新生！

使用ng-metadata让Angular 1焕发新生！

🎉 欢迎来到Angular 2风格的Angular 1.x世界！有了这个令人惊叹的开源项目——ng-metadata，您可以逐步将现有的Angular 1代码库更新为TypeScript/ES2015，同时利用Angular 2的装饰器API。这是真正的生产级解决方案，适用于Angular 1.4及以上版本。

项目介绍

ng-metadata是一个革命性的工具，它将Angular 2的大部分API回移植到Angular 1.x中。它的目标是帮助开发者以Angular 2的方式编写和组织代码，而无需离开Angular 1环境。不仅如此，ng-metadata还遵循了TypeScript的扩展，提供了一流的装饰器支持，包括方法和参数装饰器（目前在TC39处于阶段0）。

技术分析

ng-metadata的核心特性在于其无侵入性，它没有引入任何额外的抽象层，而是直接在Angular 1.x下工作。通过使用装饰器，你可以摆脱Angular 1中的link函数、$scope、$element等API的复杂语法，转而采用更清晰、更组件化的编码方式。升级策略灵活多样，可以按文件进行，也可以在根应用组件上注册，甚至混合使用。

应用场景

ng-metadata特别适合那些希望逐渐演进旧代码库至Angular 2的项目。它可以用于创建新项目，或者作为现有项目的迁移路径，使得开发团队能够逐渐适应Angular 2的设计模式，同时保持对旧版Angular 1.x的兼容。

此外，对于正在学习Angular 2但不想立即完全迁移到新框架的人来说，这是一个完美的实践平台。

项目特点

• 干净的Angular 2样式依赖注入与Angular 1结合。
• 提升生产力，让你在今天就能使用Angular 2的编程风格。
• 去除Angular 1 API的冗余，如DDO（Directives Definition Object）定义等。
• 全面支持TypeScript，借助装饰器实现声明式编程。
• 强制组件化思维方式，鼓励编写结构清晰的应用。
• 在生产环境中经过验证，适用于大型项目。

要快速体验ng-metadata的魅力，可以访问提供的在线示例、实时文档和生产就绪的启动套件。

在开始之前，请务必阅读引导教程，浏览文档并查看常见问题解答，以便更好地理解如何使用ng-metadata。

现在，让我们对比一下传统Angular 1.x与现代ng-metadata应用程序的差异，并感受其中的变化：

传统Angular 1.x ES5示例：

// ...

ng-metadata + TypeScript示例：

// ...

安装与配置

首先确保你的环境中安装了Node.js 5.x.x以上和npm 3.x.x。然后通过以下步骤设置项目：

1. 安装核心依赖：npm i --save angular angular-mocks ng-metadata
2. 添加polyfills：npm i --save rxjs@5.0.1 core-js reflect-metadata
3. 配置tsconfig.json、typings以及选择合适的模块加载器/打包器。

准备好这些，你就可以开始享受ng-metadata带来的便利和乐趣了！

立即加入社区，分享你的见解，共同推动Angular 1.x的进步！这不仅是一次升级，更是一种新的开发体验。让我们一起，用ng-metadata重新定义你的Angular 1代码！🚀