ARGOMENTI×
Developer quick start
Seguono alcune informazioni su come implementare la libreria della piattaforma UWP (Universal Windows Platform).
Per implementare l’SDK, è necessario Visual Studio 2013 o versione successiva.
Scaricare l'SDK
After you unzip the
SDK download
file, you will have a separate folder for each supported architecture and platform combination. Avrete anche un
ADBMobileConfig.json
file. Per ulteriori informazioni su questo file, consulta il file
di configurazione
ADBMobileConfig.json.
Select the correct version
Different
.dll/.winmd
files are provided for each supported architecture (x86, x64, ARM).
The version of
ADBMobile.winmd
does not reflect the version of the library. Il
.winmd
file contiene solo i metadati e ha un numero di versione
255.255.255.255
, il che è un comportamento accettato secondo Microsoft. Per ulteriori informazioni, vedere
Come si aggiungono le informazioni sull'assembly per una dll componente WinRT C++ / CX?
. To check the version of the library you are using, check the version of the underlying
ADBMobile.dll
file.
Differenze di sintassi
La libreria della piattaforma UWP (Universal Windows Platform) può essere utilizzata in vari linguaggi di programmazione. Gli esempi contenuti in questa guida sono in WinJS (JavaScript), se utilizzi un linguaggio diverso, potrebbero dover essere modificati. Quando utilizzi metodi winmd da winJS, tutti i metodi hanno automaticamente la prima lettera minuscola.
La differenza principale tra le implementazioni è la struttura dei dati utilizzata per i dati contestuali. Additionally, when using the SDK in a WinJS project, use an empty string (
""
or
''
) instead of
null
for empty string values.
Add the library and config File to your project - C#
- Avvia Visual Studio e apri la soluzione.
- In the Solution Explorer , right-click References and select Add Reference .
- Seleziona la versione corretta della libreria e individua il file ADBMobile.winmd associato.Per ulteriori informazioni, consultate Selezionare la sezione sulla versione corretta in questa pagina.
- Fai clic su Aggiungi .
- Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
- In the Solution Explorer , right-click References and select Add Reference .Se hai anche un progetto C++ nella soluzione, salta questo passaggio.
- Nella scheda Windows a sinistra, selezionare Estensioni , selezionare e aggiungere Runtime Visual C++ 2015 per le app della piattaforma UWP (Universal Windows Platform).
- Aggiungi la riga seguente alla classe:
using ADBMobile;
- Right-click your project and click Add > Existing Item .
- Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
- Fare clic con il pulsante destro del mouse sul ADBMobileConfig.json file nella soluzione e selezionare Proprietà .
- Cambia Operazione di generazione in Contenuto .
Add the library and config file to your project - C++
- Avvia Visual Studio e apri la soluzione.
- In the Solution Explorer , right-click your project and select Add > References .
- Seleziona la versione corretta della libreria e aggiungi un riferimento al file ADBMobile.winmd associato.Per ulteriori informazioni, consultate Selezionare la sezione sulla versione corretta in questa pagina.
- Fai clic su Aggiungi .
- Verifica che ADBMobile.winmd sia selezionato nella finestraGestione riferimenti e fai clic su OK .
- Aggiungi la riga seguente alla classe:
using namespace ADBMobile;
- Right-click your project and select Add > Existing Item .
- Browse to ADBMobileConfig.json file and click Add .
- Right-click the ADBMobileConfig.json file in your solution and select Properties .
- On the General tab, change Content to Yes and click OK .
Add the library and config file to your project - WinJS
- Avvia Visual Studio e apri la soluzione.
- In the Solution Explorer , right-click References and select Add Reference .
- Seleziona la versione corretta della libreria e individua il file ADBMobile.winmd associato.
- Fai clic su Aggiungi .
- Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
- In the Solution Explorer , right-click References and select Add Reference .Se hai anche un progetto C++ nella soluzione, salta questo passaggio.
- Nella scheda Windows a sinistra, selezionare Estensioni , quindi selezionare e aggiungere Runtime Visual C++ 2015 per le app della piattaforma UWP (Universal Windows Platform).
- Right-click your project and select Add > Existing Item .
- Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
- Right-click the ADBMobileConfig.json file in your solution and select Properties .
- Con Proprietà file selezionato, accertati che Azione pacchetto sia impostata su Contenuto .Per i progetti JavaScript, il file è impostato su Contenuto per impostazione predefinita.
Update The ADBMobileConfig.json config file
The
ADBMobileConfig.json
file contains global SDK settings and is located at your project root after you complete the steps in the
Add the library and config file to your project
section. If your
ADBMobileConfig.json
file was not pre-configured by Adobe Mobile Services, you need to update a few values to get started.
Ecco un esempio di file
ADBMobileConfig.json
:
{ "version" : "1.0", "analytics" : { "rsids" : "coolApp", "server" : "my.CoolApp.com", "charset" : "UTF-8", "ssl" : true, "offlineEnabled" : true, "lifecycleTimeout" : 300, "privacyDefault" : "optedin", "poi" : [ ["san francisco",37.757144,-122.44812,7000], ["santa cruz",36.972935,-122.01725,600] ] }, "target" : { "clientCode" : "myTargetClientCode", "timeout" : 1 }, "audienceManager" : { "server" : "myServer.demdex.com" } }
Come minimo, aggiornate i seguenti valori per le soluzioni in uso:
- Adobe Analytics : rsids and server
- Adobe Target : clientCode
- Adobe Audience Manager : server
Per ulteriori informazioni, consulta Metodi
SDK methods
SDK.
Eseguire il debug
Per abilitare il debug per l’SDK, chiama
ADBMobile.Config.setDebugLogging(true);
.
Per le app C Sharp e JavaScript, è necessario abilitare il debug del codice nativo eseguendo i passaggi seguenti (il debug del codice nativo è l'impostazione predefinita per le app C++):
C Nitido
- Fare clic con il pulsante destro del mouse sul progetto, quindi scegliere Proprietà > scheda Debug.
- Cambia l’elenco a discesa del tipo di debug in Native Only (Solo nativo) .
JavaScript
- Right-click the project, click Properties > Configuration Properties > Debug tab .
- Nell’elenco a discesa, cambia il tipo di debugger in Solo nativo .
Tutto qui. A questo punto sei pronto per implementare Analytics, Target e Gestione dell'audience nell’app della piattaforma UWP (Universal Windows Platform).