Skip to content

Commit

Permalink
Scoping doc (#4679)
Browse files Browse the repository at this point in the history
* Scoping doc

* Update Scoping.md
  • Loading branch information
PureWeen committed May 20, 2022
1 parent d323b70 commit da75bff
Showing 1 changed file with 42 additions and 0 deletions.
42 changes: 42 additions & 0 deletions docs/design/Scoping.md
@@ -0,0 +1,42 @@
.NET MAUI Scopes
===

# Introduction

.NET MAUI currently uses the [CreateScope](https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.dependencyinjection.serviceproviderserviceextensions.createscope?view=dotnet-plat-ext-6.0) feature of MS.Ext.DI to create services that are scoped to the .NET MAUI concept of a window (AppCompatActivity, UIScene, UI.XAML.Window).

We also have an internal scoping mechanism that we use to scope aspects of the platform application with a lifecycle that isn't tied to a Window.

## Window Scoping

When a new Window is created we take the Application level `IServiceProvider` and generate a [new scope](https://github.com/dotnet/maui/blob/c1525fad1af4ff32aa7abe00119be94f7399d98f/src/Core/src/Platform/Android/ApplicationExtensions.cs#L38).

This allows us to register things that need to be scoped to a window (`IDispatcher`, `ITicket`, `IAnimationManager`)

## Blazor Scoping

???

## Custom internal scoping

### (`WrappedServiceProvider`)[https://github.com/dotnet/maui/blob/b09979d93ac544d4b0dd9fd0df5c25da7e91392c/src/Core/src/MauiContext.cs#L47]

```csharp
class WrappedServiceProvider : IServiceProvider
```

The purpose of this class is to intercept `GetServices` requests and return anything that we've registered as scoped to this particular `WrappedServiceProvider`. The primary reason for us needing to do this is that the Ms.Ext.DI `ServiceProvider` implementation only allows you to create a single level of scoping but we need a mechanism to create types that are scoped to particular areas of a window.

#### Modal Page scoping
We use this feature for `ModalPages`. Because `ModalPages` are basically a "Virtual Window" we use the `WrappedServiceProvider` to create sets of types that need to be scoped to this new Virtual Window instead of the actual window. For example things like the toolbar or top level container the user sees are all scoped to the "Virtual Window".

#### Android Fragment scoping
This scoping feature is very useful within Android because with (Android)[https://github.com/dotnet/maui/blob/8d8be50f4f94457b30551d7ffb020b6e5bb48915/src/Core/src/Platform/Android/MauiContextExtensions.cs#L51] you will get areas of your View that have to use features of a parent view opposed to those same features on the window. Think of it like needing different scopes for each context that exists within a window.
- Window Scope (this is for views created at the window level)
- Tab Scope (this is for views that are created inside each Tab.)
- Navigation Scope (this is for views that are created inside the Navigation)


#### Limitations
Any services registered with the `WrappedServiceProvider` don't participate in the resolution used by the Ms.Ext.DI. The way the `WrappedServiceProvider` works is that it checks an internal dictionary for a requested `Type`. If it doesn't find that type then it passes the request to whatever it's wrapped. So on and so forth until it reaches window scoped `IServiceProvider`

0 comments on commit da75bff

Please sign in to comment.