Other MAUI and Xamarin APIs
Important
Visual Studio App Center is scheduled for retirement on March 31, 2025. While you can continue to use Visual Studio App Center until it is fully retired, there are several recommended alternatives that you may consider migrating to.
Adjust the log level
You can control the amount of log messages that show up from App Center in the console. Use the LogLevel
-API to enable additional logging while debugging. By default, it's set to ASSERT
for the App Store environments and WARN
otherwise.
To have as many log messages as possible, use LogLevel.Verbose
.
AppCenter.LogLevel = LogLevel.Verbose;
Identify installations
The App Center SDK creates a UUID for each device once the app is installed. This identifier remains the same for a device when the app is updated and a new one is generated only when the app is re-installed. The following API is useful for debugging purposes.
System.Guid? installId = await AppCenter.GetInstallIdAsync();
Note
On Android, this method must only be used after AppCenter
has been started, it will always return null
before start.
Identify users
The App Center SDK supports setting a user ID that's used to augment crash reports. To use this capability:
- Configure the App Center SDK by calling
AppCenter.Start(...)
as described in the Getting started guide. - Set a
userID
in the SDK using the following code:
AppCenter.SetUserId("your-user-id");
After setting a user ID, you can use App Center's search feature to search for specific crash reports for the ID. Learn more in App Center's search documentation.
Note
The value for the user ID is limited to 256 characters. It will be shown with your crash reports but not used for aggregation or counts of affected users. In case you set user ID multiple times, only the last user ID will be used. You need to set the user ID yourself before each application launch, because this value isn't stored by the SDK between launches.
Disable all services at runtime
If you want to disable all App Center services at once, use the Enabled
property. When disabled, the SDK won't forward any information to App Center.
AppCenter.SetEnabledAsync(false);
To enable all services at once again, use the same API but pass true
as a parameter.
AppCenter.SetEnabledAsync(true);
You don't need to await this call to make other API calls (such as IsEnabledAsync
) consistent.
The state is persisted in the device's storage across application launches.
Note
This method must only be used after AppCenter
has been started.
Disallow network requests
In the App Center SDK, network requests are allowed by default. If you want to send data that the App Center SDK collects by the user concern you can disallow automatic sending data.
AppCenter.IsNetworkRequestsAllowed = false;
In this case, the App Center SDK continues to collect data but it will be sent only when the network requests will be allowed.
AppCenter.IsNetworkRequestsAllowed = true;
Note
This value is retained between starts.
At any time, you can check whether sending data in the App Center SDK is allowed or not.
AppCenter.IsNetworkRequestsAllowed;
Note
The value saved previously in SharedPreferences
is ignored until AppCenter
is started on Android platform.
It will return the last value set using AppCenter.IsNetworkRequestsAllowed = allowed
or true
if the value wasn't changed before AppCenter start.
Change state of service in runtime
You can enable or disable the service at runtime with the following code:
Analytics.SetEnabledAsync(true);
Note
This method must only be used after Analytics
has been started.
Check if App Center is enabled
You can also check if App Center is enabled or not.
bool enabled = await AppCenter.IsEnabledAsync();
Note
This method must only be used after AppCenter
has been started, it will always return false
before start.
Check App Center SDK version at runtime
You can get the version of App Center SDK that you're currently using.
AppCenter.SdkVersion;