Infsoft.WPE.App.Base
1.0.0-next07
Prefix Reserved
See the version list below for details.
dotnet add package Infsoft.WPE.App.Base --version 1.0.0-next07
NuGet\Install-Package Infsoft.WPE.App.Base -Version 1.0.0-next07
<PackageReference Include="Infsoft.WPE.App.Base" Version="1.0.0-next07" />
paket add Infsoft.WPE.App.Base --version 1.0.0-next07
#r "nuget: Infsoft.WPE.App.Base, 1.0.0-next07"
// Install Infsoft.WPE.App.Base as a Cake Addin #addin nuget:?package=Infsoft.WPE.App.Base&version=1.0.0-next07&prerelease // Install Infsoft.WPE.App.Base as a Cake Tool #tool nuget:?package=Infsoft.WPE.App.Base&version=1.0.0-next07&prerelease
Workplace Experience (WPE) App Base Library
This library contains attributes and interfaces required to implement dynamic apps.
SUMMARY: Your app should implement IAppExtensions and annotate components with the below attributes, any annotated component must implement AppComponent or AppJsComponent and can use it's method to resolve services registered in the
IAppExtensions.RegisterServices
method. Additionally you must define all used routes (that require authentication).
NOTE: Version 1.0 of this library contains breaking changes and should only be used for WPE 3.0
Attributes
The following attributes allow marking of Blazor components as specific components, which can be dynamically rendered in infsoft's Workplace Experience application.
- App Fullscreen content of module (navbar not visible)
- NavEntry Entry to be rendered in the app's navbar
- PoI Content to be rendered for a singular POI
- Tile Content to be rendered as tile
Notable changes to pre 1.0:
- No mobile attribute present or necessary, use media-queries instead.
- Reduced number of attribute entrypoints
- Interface changes to comply with new architecture of application
Interfaces
Some of the above mentioned attributes require the component to implement a specific interface. This is required to pass parameters to the component dynamically.
- IPoIParameters Any PoI component receives the unique identifier of the PoI it was opened for, as well as any properties the PoI might specify
- ISubscriptionParameter Any app or tile receives the subscription it should be rendered for (this is optional, if your tile does not require any subscription specific data)
- INameParameter Allows apps, tiles and navEntries to define their name, it's used for the page title, tile name and nav entry name respectively.
Defining Route mappings
This section is only relevant for the web application, native apps will ignore the mappings.
The application utilizes a Backend for Frontend (BFF)
pattern, as such all requests that require authentication/authorization on the backend, must be proxied by the web backend.
To achieve this dynamically, each app must implement GetRouteMappings
of the IAppExtensions interface.
Every request made by your app, will be filtered according to your mappings and whenever a request starts with one of the mapped absolutePaths, it is replaced with the web's base url and your defined prefixed.
Then the request is made towards the web backend, which utilizes the application cookie to authorize the request and proxy it back to your original URL.
Dependency Injection
Services can be registered with the container for Dependency Injection. Simply follow the below guidelines.
Service registration
Every developed module might require the registration of services for dependency injection.
To allow this, an extension point is provided by implementing the corresponding IAppExtensions interface.
Every service, that is registered with the RegisterServices
method, will be registered in a custom scope unique to the module.
This allows for quick dynamic assembly loading after startup.
Service injection
To inject your services, two possiblities exist:
- In normal
.cs
files, you can use constructor injection as you would anywhere else - In razor components, you have to inherit from the provided AppComponent or AppJsComponent and use the provided method to set your service instances.
Services, that are provided globally (by infsoft), e.g. the JavaScript runtime, can be injected with the
@inject
directive. Sample:@using Infsoft.WPE.App.Modules.Base @inherits AppComponent @inject IJSRuntime JSRuntime @code { private ISampleService SampleService; protected override void OnInitialized() { base.OnInitialized(); SampleService = GetService<ISampleService>(); } }
JavaScript Modules
One caveat of separating the assemblies in different contexts, is that you cannot directly inject IJSRuntime
into your code wrapper for the JavaScript code.
You can only use IJSRuntime
by injecting it in the razor classes and then passing it along to your module class as a method parameter.
Therefore, if you do not have JS code shared between multiple razor classes, you can simply inherit from AppJsComponent.
This class provides you with InvokeVoidAsync
and InvokeAsync
methods, which will automatically load your module scoped JavaScript.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Autofac (>= 8.0.0)
- Infsoft.WPE.App.Services (>= 0.1.0-next10)
- Microsoft.AspNetCore.Components.Web (>= 8.0.6)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Infsoft.WPE.App.Base:
Package | Downloads |
---|---|
Infsoft.WPE.App.Authentication.Base
Base authentication library used in platform dependent auth libraries (Infsoft.WPE.App.Authentication.Web and Infsoft.WPE.App.Authentication.Maui) for infsoft's Workplace Experience application |
|
Infsoft.WPE.App.Test
Base library for bunit tests, allowing to inject scoped autoFac services |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0-next27 | 102 | 7/26/2024 |
1.0.0-next26 | 42 | 7/26/2024 |
1.0.0-next25 | 54 | 7/26/2024 |
1.0.0-next24 | 62 | 7/24/2024 |
1.0.0-next23 | 53 | 7/23/2024 |
1.0.0-next22 | 69 | 7/22/2024 |
1.0.0-next21 | 43 | 7/22/2024 |
1.0.0-next20 | 50 | 7/15/2024 |
1.0.0-next19 | 36 | 7/15/2024 |
1.0.0-next18 | 58 | 7/5/2024 |
1.0.0-next17 | 53 | 7/4/2024 |
1.0.0-next16 | 41 | 7/4/2024 |
1.0.0-next15 | 64 | 7/1/2024 |
1.0.0-next14 | 40 | 7/1/2024 |
1.0.0-next13 | 41 | 7/1/2024 |
1.0.0-next12 | 39 | 7/1/2024 |
1.0.0-next11 | 40 | 7/1/2024 |
1.0.0-next10 | 42 | 6/27/2024 |
1.0.0-next09 | 62 | 6/19/2024 |
1.0.0-next08 | 66 | 6/4/2024 |
1.0.0-next07 | 64 | 6/3/2024 |
1.0.0-next06 | 104 | 5/23/2024 |
1.0.0-next05 | 55 | 5/23/2024 |
1.0.0-next04 | 52 | 5/22/2024 |
1.0.0-next03 | 47 | 5/21/2024 |
1.0.0-next02 | 48 | 5/21/2024 |
1.0.0-next01 | 50 | 5/21/2024 |
1.0.0-next | 51 | 5/21/2024 |