Procedure di aggiornamento dell'SDK per Windows Phone SilverlightWindows Phone Silverlight SDK Upgrade Procedures

Se è già stata eseguita l'integrazione di una versione precedente dell'SDK nell'applicazione, sarà necessario tenere in considerazione gli aspetti seguenti durante l'aggiornamento dell'SDK.If you already have integrated an older version of our SDK into your application, you have to consider the following points when upgrading the SDK.

Se non sono state applicate alcune versioni dell'SDK, potrebbe essere necessario eseguire più procedure.You may have to follow several procedures if you missed several versions of the SDK. Se ad esempio si esegue la migrazione dalla versione 0.10.1 alla 0.11.0, sarà prima di tutto necessario eseguire la procedura per la migrazione "dalla 0.9.0 alla 0.10.1" e quindi la procedura per la migrazione "dalla 0.10.1 alla 0.11.0".For example if you migrate from 0.10.1 to 0.11.0 you have to first follow the "from 0.9.0 to 0.10.1" procedure then the "from 0.10.1 to 0.11.0" procedure.

Dalla versione 2.0.0 alla 3.3.0From 2.0.0 to 3.3.0

Log di testTest logs

I log della console generati da SDK possono essere abilitati/disattivati/filtrati.Console logs produced by the SDK can now be enabled/disabled/filtered. Per eseguire una personalizzazione, aggiornare la proprietà EngagementAgent.Instance.TestLogEnabled scegliendo uno dei valori disponibili nell'enumerazione EngagementTestLogLevel, ad esempio:To customize this, update the property EngagementAgent.Instance.TestLogEnabled to one of the value available from the EngagementTestLogLevel enumeration, for instance:

        EngagementAgent.Instance.TestLogLevel = EngagementTestLogLevel.Verbose;
        EngagementAgent.Instance.Init();

Dalla versione 1.1.1 alla 2.0.0From 1.1.1 to 2.0.0

La sezione seguente illustra come eseguire la migrazione di un'integrazione dell'SDK dal servizio Capptain offerto da Capptain SAS a un'app basata su Azure Mobile Engagement.The following describes how to migrate an SDK integration from the Capptain service offered by Capptain SAS into an app powered by Azure Mobile Engagement.

Importante

Capptain e Mobile Engagement sono servizi diversi e la procedura seguente illustra solo come eseguire la migrazione dell'app client.Capptain and Mobile Engagement are not the same services and the procedure given below only highlights how to migrate the client app. La migrazione dell'SDK nell'app NON comporta la migrazione dei dati dai server di Capptain ai server di Mobile EngagementMigrating the SDK in the app will NOT migrate your data from the Capptain servers to the Mobile Engagement servers

Se si esegue la migrazione da una versione precedente, consultare il sito web Capptain per eseguire prima la migrazione a 1.1.1, quindi applicare la procedura seguenteIf you are migrating from an earlier version, please consult the Capptain web site to migrate to 1.1.1 first then apply the following procedure

Pacchetto NuGetNuget package

Sostituire Capptain.WindowsPhone con il pacchetto NuGet MicrosoftAzure.MobileEngagement.Replace Capptain.WindowsPhone by MicrosoftAzure.MobileEngagement Nuget package.

Applicazione di Mobile EngagementApplying Mobile Engagement

L'SDK usa il termine Engagement.The SDK uses the term Engagement. È necessario aggiornare il progetto per tenere conto di questa modifica.You need to update your project to match this change.

È necessario disinstallare il pacchetto nuget corrente di Capptain.You need to uninstall your current Capptain nuget package. Si consideri che verranno rimosse tutte le modifiche nella cartella Risorse di Capptain.Consider that all your changes in Capptain Resources folder will be removed. Se si desidera mantenere tali file, eseguirne una copia.If you want to keep those files then make a copy of them.

Successivamente, installare il nuovo pacchetto NuGet di Microsoft Azure Engagement nel progetto.After that, install the new Microsoft Azure Engagement nuget package on your project. È possibile trovarlo direttamente sul sito Web di NuGet.You can find it directly on Nuget. Questa operazione sostituisce tutti i file di risorse utilizzati da Engagement e aggiunge la nuova DLL di Engagement ai riferimenti del progetto.This action replaces all resources files used by Engagement and adds the new Engagement DLL to your project References.

È necessario eliminare i riferimenti del progetto rimuovendo i riferimenti DLL di Capptain.You have to clean your project references by deleting Capptain DLL references. Se non si effettua questa operazione, la versione di Capptain creerà un conflitto e si verificheranno errori.If you do not make this, the version of Capptain will conflict and errors will happen.

Se sono state personalizzate risorse Capptain, copiare il contenuto dei file precedenti e incollarlo in nuovi file di progetto.If you have customized Capptain resources, copy your old files content and paste them in the new Engagement files. Si noti che è necessario aggiornare sia i file xaml che i file cs.Please note that both xaml and cs files have to be updated.

Al termine di queste operazioni, è necessario sostituire i riferimenti di Capptain precedenti con i nuovi riferimenti di Engagement.When those steps are completed you only have to replace old Capptain references by the new Engagement references.

  1. Tutti gli spazi dei nomi Capptain devono essere aggiornati.All Capptain namespaces have to be updated.

    Prima della migrazione:Before migration:

     using Capptain.Agent;
     using Capptain.Reach;
    

    Dopo la migrazione:After migration:

     using Microsoft.Azure.Engagement;
    
  2. Tutte le classi Capptain che contengono "Capptain" devono contenere "Engagement".All Capptain classes that contain "Capptain" should contain "Engagement".

    Prima della migrazione:Before migration:

     public sealed partial class MainPage : CapptainPage
     {
       protected override string GetCapptainPageName()
       {
         return "Capptain Demo";
       }
       ...
     }
    

    Dopo la migrazione:After migration:

     public sealed partial class MainPage : EngagementPage
     {
       protected override string GetEngagementPageName()
       {
         return "Engagement Demo";
       }
       ...
     }
    
  3. Per i file xaml cambiano anche attributi e spazio dei nomi di Capptain.For xaml files Capptain namespace and attributes also change.

    Prima della migrazione:Before migration:

     <capptain:CapptainPage
     ...
     xmlns:capptain="clr-namespace:Capptain.Agent;assembly=Capptain.Agent.WP"
     ...
     </capptain:CapptainPage>
    

    Dopo la migrazione:After migration:

     <engagement:EngagementPage
     ...
     xmlns:engagement="clr-namespace:Microsoft.Azure.Engagement;assembly=Microsoft.Azure.Engagement.EngagementAgent.WP"
     ...
     </engagement:EngagementPage>
    
  4. Per altre risorse come le immagini di Capptain, tenere presente che sono state rinominate per l'utilizzo di "Engagement".For the other resources like Capptain pictures, please note that they also have been renamed to use "Engagement".

ID applicazione / chiave SDKApplication ID / SDK Key

Engagement utilizza una stringa di connessione.Engagement uses a connection string. Non è necessario specificare un ID applicazione e una chiave SDK con Mobile Engagement, è sufficiente specificare una stringa di connessione.You don't have to specify an application ID and an SDK key with Mobile Engagement, you only have to specify a connection string. È possibile configurarla nel file EngagementConfiguration.You can set it up on your EngagementConfiguration file.

La configurazione di Engagement può essere impostata nel file Resources\EngagementConfiguration.xml del progetto.The Engagement configuration can be set in your Resources\EngagementConfiguration.xml file of your project.

Modificare questo file per specificare:Edit this file to specify:

  • La stringa di connessione dell'applicazione tra i tag <connectionString> and <\connectionString>.Your application connection string between tags <connectionString> and <\connectionString>.

Se si desidera specificarla in fase di esecuzione, è possibile chiamare il metodo seguente prima dell'inizializzazione dell'agente di Engagement:If you want to specify it at runtime instead, you can call the following method before the Engagement agent initialization:

    /* Engagement configuration. */
    EngagementConfiguration engagementConfiguration = new EngagementConfiguration();
    engagementConfiguration.Agent.ConnectionString = "Endpoint={appCollection}.{domain};AppId={appId};SdkKey={sdkKey}";

    /* Initialize Engagement angent with above configuration. */
    EngagementAgent.Instance.Init(engagementConfiguration);

La stringa di connessione per l'applicazione viene visualizzata nel portale di Azure classico.The connection string for your application is displayed in the Azure Classic Portal.

Modifica del nome di elementiItems name change

Tutti gli elementi denominati capptain sono stati rinominati in engagement.All items named capptain have been named engagement. Lo stesso vale per Capptain, che è stato ridenominato in Engagement.Similarly for Capptain to Engagement.

Esempi di elementi di Capptain di uso comune:Examples of commonly used Capptain items :

  • CapptainConfiguration è diventato EngagementConfigurationCapptainConfiguration now named EngagementConfiguration
  • CapptainAgent è diventato EngagementAgentCapptainAgent now named EngagementAgent
  • CapptainReach è diventato EngagementReachCapptainReach now named EngagementReach
  • CapptainHttpConfig è diventato EngagementHttpConfigCapptainHttpConfig now named EngagementHttpConfig
  • GetCapptainPageName è diventato GetEngagementPageNameGetCapptainPageName now named GetEngagementPageName

Si noti la ridenominazione influisce anche sui metodi sottoposti a override.Note that rename also affects overridden methods.