In questi giorni mi trovo, per lavoro e per la community, a smanettare con Caliburn.Micro (che tra le altre cose consiglio perché se ci riesco a lavorare io, significa che è veramente fatto bene).
Ho notato che, agganciando il framework con NuGet all’interno di un progetto Visual Basic.Net, compaiono le classi di bootstrap, la shell e l’interfaccia che definisce la shell ma con la spiacevole controindicazione che sono in C#.
Questo post ha lo scopo di spiegare come agganciare Caliburn con NuGet in un progetto VB.NET.
Agganciare il framework con NuGet è semplicissimo (come lo è sempre utilizzando NuGet). In questo caso stiamo parlando di un progetto WPF, ma la procedura è identica per Silverlight o WP7.
Per cominciare accertiamoci di aver installato ed abilitato NuGet tra le estensioni di VS (basta vedere se con il tasto destro su un progetto appare il menù contestuale “Add Library Package Reference…”).
Lanciamo il comando precedente sul progetto in cui vogliamo aggiungere Caliburn.Micro e selezioniamo il package dalla maschera:
Il tasto install ci consente di istallare e configurare Caliburn.Micro.
Al termine dell’installazione il progetto apparirà nel seguente modo:
Rimuoviamo i file .cs e inseriamo gli omonimi file .vb con le classi che riporto di seguito:
Appbootstrapper.vb
- Imports Caliburn.Micro
- Imports System.ComponentModel.Composition.Hosting
- Imports System.ComponentModel.Composition.Primitives
- ImportsSystem.ComponentModel.Composition
- Public Class AppBootstrapper
- Inherits Bootstrapper(Of IShell)
- Private container As CompositionContainer
- ' <summary>
- ' By default, we are configured to use MEF
- ' </summary>
- Protected Overrides Sub Configure()
- Dim catalog = New AggregateCatalog(AssemblySource.Instance.Select(Function(x) New AssemblyCatalog(x)).OfType(Of ComposablePartCatalog)())
- container = New CompositionContainer(catalog)
- Dim batch = New CompositionBatch()
- batch.AddExportedValue(Of IWindowManager)(New WindowManager())
- batch.AddExportedValue(Of IEventAggregator)(New EventAggregator())
- batch.AddExportedValue(container)
- batch.AddExportedValue(catalog)
- container.Compose(batch)
- End Sub
- Protected Overrides Function GetInstance(service As System.Type, key As String) As Object
- Dim contract = If(String.IsNullOrEmpty(key), AttributedModelServices.GetContractName(service), key)
- Dim exports = container.GetExportedValues(Of Object)(contract)
- If exports.Count() > 0 Then Return exports.First()
- Throw New Exception(String.Format("Could not locate any instances of contract {0}.", contract))
- End Function
- Protected Overrides Function GetAllInstances(service As System.Type) As System.Collections.Generic.IEnumerable(Of Object)
- Return container.GetExportedValues(Of Object)(AttributedModelServices.GetContractName(service))
- End Function
- Protected Overrides Sub BuildUp(instance As Object)
- container.SatisfyImportsOnce(instance)
- End Sub
- End Class
IShell.vb
- Public Interface IShell
- End Interface
ShellViewModel.vb
- Imports System.ComponentModel.Composition
- <Export(GetType(IShell))>
- Public Class ShellViewModel
- Implements IShell
- End Class
Le classi possono ovviamente essere personalizzate sia nel comportamento che nei namespace.
Con l’inserimento di queste classi, il progetto assume la forma:
Per la configurazione dello startup dell’applicazione fate riferimento alla documentazione di Caliburn.Micro (http://caliburnmicro.codeplex.com/wikipage?title=Nuget&referringTitle=Documentation) che spiega passo passo cosa fare.
Ricordatevi di fare attenzione ai namespace della ShellView e della ShellViewModel per fare in modo che Caliburn riesca ad associarle.
In particolare è necessario prestare attenzione alla ShellView. Il package NuGet, infatti, crea il seguente Xaml:
- <Window x:Class="NomeProgetto.ShellView"
- xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
- xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
- <Grid Background="White">
- <TextBlock Text="Hello Caliburn Micro!"
- VerticalAlignment="Center"
- HorizontalAlignment="Center"
- FontSize="20" />
- </Grid>
- </Window>
Come possiamo osservare la classe ShellView si trova nel namespace “NomeProgetto.ShellView”, mentre la ShellViewModel (così come definita in precedenza) nel namespace root. In questo caso la convenzione che sta alla base del funzionamento di Caliburn non è in grado di associare View e ViewModel ed otterrete:
Per risolvere il problema è sufficiente togliere il namespace davanti al nome della classe nella view.
Commenti