Better Angular Architectures With Angular Libraries

Angular offers many possibilities when it comes to the separation and architecture of your application. There is often code that you not only want to reuse within your application, but also make available to other applications in your organization or over the web via package managers like npm. This is where Angular's libraries come into play. In this talk, Fabian Gosebrink will highlight how Angular libraries are created, what the Angular Package Format is good for, and how we can move code from an existing application into an Angular library to reuse the code across multiple applications. This makes maintainability and architecture of Angular applications a breeze.

Transcript

1. View Slide

2. View Slide

3. View Slide

4. View Slide

5. View Slide

6. View Slide

7. View Slide

8. View Slide

9. View Slide

10. View Slide

11. View Slide

12. View Slide

13. View Slide

14. View Slide

15. View Slide

16. View Slide

17. View Slide

18. View Slide

19. View Slide

20. View Slide

21. View Slide

22. View Slide

23. View Slide

24. View Slide

25. View Slide

26. View Slide

27. View Slide

28. View Slide

29. View Slide

30. View Slide

31. View Slide

32. View Slide

33. View Slide

34. View Slide

35. View Slide

36. View Slide

37. @NgModule({
    declarations: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

38. import { XyzModule } from ‘folder’;
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

39. MyComponent
    import { XyzModule } from ‘folder’;
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

40. MyComponent
    import { XyzModule } from ‘folder’;
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

41. MyComponent
    import { XyzModule } from ‘folder’;
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

42. @NgModule({
    imports: [
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

43. import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    

    View Slide

44. import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    public-api.ts
    export * from ‘./xyz.module’
    

    View Slide

45. import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    public-api.ts
    MyComponent
    export * from ‘./xyz.module’
    

    View Slide

46. import { XyzModule, MyComponent } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    public-api.ts
    MyComponent
    export * from ‘./xyz.module’
    

    View Slide

47. import { XyzModule, MyComponent } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    public-api.ts
    MyComponent
    export * from ‘./xyz.module’
    

    View Slide

48. import { XyzModule, MyComponent } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    @NgModule({
    declarations: [MyComponent],
    exports: [MyComponent]
    })
    export class XyzModule
    MyComponent
    public-api.ts
    MyComponent
    export * from ‘./xyz.module’
    export * from ‘./my.component’
    

    View Slide

49. @NgModule({
    providers: [MyService]
    })
    export class XyzModule
    MyService
    

    View Slide

50. @NgModule({
    providers: [MyService]
    })
    export class XyzModule
    MyService
    public-api.ts
    export * from ‘./xyz.module’
    

    View Slide

51. @NgModule({
    providers: [MyService]
    })
    export class XyzModule
    MyService
    public-api.ts
    import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    export * from ‘./xyz.module’
    

    View Slide

52. @NgModule({
    providers: [MyService]
    })
    export class XyzModule
    MyService
    public-api.ts
    import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    import { MyService } from ‘lib’;
    constructor(private srv: MyService) {}
    export * from ‘./xyz.module’
    

    View Slide

53. @NgModule({
    providers: [MyService]
    })
    export class XyzModule
    MyService
    public-api.ts
    import { XyzModule } from ‘lib’
    @NgModule({
    imports: [
    XyzModule
    ]})
    export class AppModule {}
    import { MyService } from ‘lib’;
    constructor(private srv: MyService) {}
    export * from ‘./xyz.module’
    export * from ‘./my.service’
    

    View Slide

54. @NgModule({
    providers: []
    })
    export class XyzModule
    @Injectable({ providedIn: ‘root’ })
    MyService
    public-api.ts
    @NgModule({
    imports: [
    ]})
    export class AppModule {}
    export * from ‘./xyz.module’
    

    View Slide

55. @NgModule({
    providers: []
    })
    export class XyzModule
    @Injectable({ providedIn: ‘root’ })
    MyService
    public-api.ts
    @NgModule({
    imports: [
    ]})
    export class AppModule {}
    import { MyService } from ‘lib’;
    constructor(private srv: MyService) {}
    export * from ‘./xyz.module’
    

    View Slide

56. @NgModule({
    providers: []
    })
    export class XyzModule
    @Injectable({ providedIn: ‘root’ })
    MyService
    public-api.ts
    @NgModule({
    imports: [
    ]})
    export class AppModule {}
    import { MyService } from ‘lib’;
    constructor(private srv: MyService) {}
    export * from ‘./xyz.module’
    export * from ‘./my.service’
    

    View Slide

57. View Slide

58. $ ng new demorepo –-createApplication=false
    $ cd demorepo
    $ ng generate app my-real-app
    $ ng generate library my-lib
    

    View Slide

59. View Slide

60. View Slide

61. $ ng build my-lib
    

    View Slide

62. $ ng build my-lib --watch
    

    View Slide

63. View Slide

64. $ ng lint my-lib
    

    View Slide

65. $ ng test my-lib
    

    View Slide

66. $ ng test my-lib –-watch=false
    

    View Slide

67. View Slide

68. View Slide

69. View Slide

70. View Slide

71. View Slide

72. View Slide

73. View Slide

74. View Slide

75. $ npm install my-lib/dist
    

    View Slide

76. $ npm link my-lib/dist
    

    View Slide

77. $ cd my-lib/dist
    $ npm pack
    $ npm install my-lib/dist/package.tgz
    

    View Slide

78. View Slide

79. View Slide

80. View Slide

81. {
    "name": "angular-rating",
    "version": "0.0.1",
    "peerDependencies": {
    "@angular/common": "^12.2.0",
    "@angular/core": "^12.2.0"
    },
    "dependencies": {
    "tslib": "^2.3.0"
    }
    }
    

    View Slide

82. {
    "name": "angular-rating",
    "version": "0.0.1",
    "peerDependencies": {
    "@angular/common": "^10.1.6",
    "@angular/core": "^10.1.6"
    },
    "dependencies": {
    "tslib": "^2.0.0"
    }
    }
    

    View Slide

83. ..
    https://semver.org/
    

    View Slide

84. {
    "name": "@fabiangosebrink/angular-rating",
    "version": "0.0.1",
    "peerDependencies": {
    "@angular/common": "^10.1.6",
    "@angular/core": "^10.1.6"
    },
    "dependencies": {
    "tslib": "^2.0.0"
    }
    }
    

    View Slide

85. View Slide

86. View Slide

87. View Slide

88. $ npx create-nx-workspace@latest
    

    View Slide

89. $ npx create-nx-workspace@latest
    $ nx generate @nrwl/angular:app my-first-app
    $ nx generate @nrwl/angular:library
    

    View Slide

90. View Slide

91. View Slide

92. View Slide

93. View Slide

94. View Slide

95. View Slide

96. View Slide

97. View Slide

98. View Slide

99. View Slide

100. View Slide

101. View Slide

102. View Slide

103. View Slide

104. View Slide

105. View Slide

106. View Slide

107. View Slide

108. View Slide

109. View Slide

110. View Slide

111. View Slide