Mobile Platform as a Service:Use SDK

Perform the following steps to diagnose the iOS client problems:

1. Initialize diagnosis service
2. Set user ID
3. Write diagnosis logs
4. View local diagnosis logs
5. Obtain online user diagnosis logs

Initialize diagnosis service

Before using the diagnosis function, initialize it first.

#import <MPDiagnosis/MPDiagnoseAdapter.h>
[MPDiagnoseAdapter initDiagnose];

The diagnosis service supports pulling logs through Sync or Push method. Codes for initializing the diagnosis service vary with the log pulling method.

Use Mobile Sync Service (Sync)

If you use the Sync method to pull diagnostic logs, you need to initialize the service before using the diagnostic function.

#import <MPDiagnosis/MPDiagnoseAdapter.h>
[MPDiagnoseAdapter initDiagnose];

Use Message Push Service (Push)

You need to integrate the Message Push Service, and complete Message Push Service initialization first. After receiving the message pushed, call the following method:

#import <APLog/APLogMgr.h>
[[APLogMgr sharedInstance] handlePushDiagnosisCmd:[notification.userInfo objectForKey:@"content"]];

Upgrade precautions

The Category file of the APLogUser class does not need to be added since version 10.1.32. The middle tier implements packaging. After upgrade, check for configurations of the earlier version in the project and delete them if any. The following shows the configurations that must be removed from the new version.

Set user ID

The diagnosis service extracts logs based on user ID.

1. Set user ID by using the userId function during the implementation of MPaaSInterface.
   

   

2. During user switching, that is, when the value configured in the userId function of MPaaSInterface changes, call the following function:

    [MPDiagnoseAdapter userChange];

   For more information, see the MPDiagnoseAdapter.h file under MPDiagnosis.

Write diagnosis logs

Call the following method to write diagnosis logs on the critical link of the App:

/**
 * Log a message with kAPLogLevelInfo level.
 *
 * @param message   An NSString object that contains a printf-style string containing a log message and placeholders for the arguments.
 * @param ...      The arguments displayed in the format string.
 */
#define APLogInfo(tag,fmt, ...) \
APLogToFile(tag, kAPLogLevelInfo, fmt, ##__VA_ARGS__)

For more information, see the APLog.h file under APLog.

For example, call the following statement to write diagnosis logs after startup:

APLogInfo(@"mPaaS", @"Start Cost %d", time);

View local diagnosis logs

You can find diagnosis logs in the sandbox directory, as shown in the following figure. This type of logs are not reported by default. The console delivers a command to extract the logs when required.

Obtain online user diagnosis logs

After your App is released and goes online, if you need to obtain the local diagnosis logs on the client for troubleshooting, you can deliver a command in the mPaaS console to obtain related diagnosis logs. For detailed operations, see Mobile Analysis > Extract logs.