Edit

Unity SDK Troubleshooting

  • Article

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.

Learn more about support timelines and alternatives.

Analytics data doesn't show up in the portal

  1. Make sure you've integrated the SDK modules correctly.
  2. Make sure your project is included the "App Center" object with attached AppCenterBehavior and your app secrets are added to the corresponding fields in the Inspector window. Make sure to also check the "Use {service}" boxes for each App Center service you intend to use.
  3. Check the logs say "App Center SDK configured successfully" (in Verbose log level), then check if you see HTTPS request logs.
  4. Make sure your device is online.
  5. At times, logs might take a few minutes to surface in the portal. Wait for some time if that’s the case.
  6. To check if App Center backend received your data, go to the Log flow section in Analytics service. Your events should appear once it's been sent.

Crashes don't show up in the portal

  1. Make sure you've integrated the SDK modules correctly.
  2. Make sure your project is included the "App Center" object with attached AppCenterBehavior and your app secrets are added to the corresponding fields in the Inspector window. Make sure to also check the "Use {service}" boxes for each App Center service you intend to use.
  3. Restart the app after a crash. App Center Crashes will forward the crash log only after it's restarted. The SDK won't save any crash log if you attached a debugger. Make sure the debugger isn't attached when you crash the app.
  4. Check the logs say "App Center SDK configured successfully" (in Verbose log level), then check if you see HTTPS request logs.
  5. Make sure your device is online.
  6. At times, logs might take a few minutes to surface in the portal. Wait for some time if that’s the case.
  7. If you want to check if the SDK detected the crash on the next app start, you can call the API to check whether the app crashed in the last session and shows an alert. Or you can extend the crash callback to see if it was successfully sent to the server.
  8. To check if App Center backend received the crash, go to the Log flow section in the Analytics service. Your crashes should appear there, once it's been sent.
  9. Make sure that the app has actually crashed and restarted: Unity catches most of the unhandled exceptions by default, meaning the app doesn't exit and it isn't considered a crash. If a crash is caught by Unity, it will be reported as "Error" by the SDK.

Android project build fails

The Distribute module version 4.1.0 or later has a new manifest tag for supporting Android 11. If you’re using Unity of version prior 2019.4 you should explicitly specify the gradle version to avoid the error AAPT: error: unexpected element <queries> found in <manifest>.. To avoid problems with building your project you have to add mainTemplate.gradle and launcherTemplate.gradle (this file should be added only if you use Unity 2019.4) files to explicitly specify the gradle version. Please open Project Settings > Player > Android tab > Publishing Settings > Build and select Custom Main Gradle Template and Custom Launcher Gradle Template. After generating files insert the following lines at the top of the files:

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.3'
    }
}

allprojects {
   repositories {
      google()
      mavenCentral()
      flatDir {
        dirs 'libs'
      }
   }
}

Read more about build for Android 11 with Unity guideline.

Protect the App Center secret value

The app_secret is an identifier of your app, it's required to know which app the traffic applies to and it can not be used to retrieve or edit existing data. If your app_secret is exposed, the biggest risk is sending bad data to your app, but it won't have an effect on the security of the data.

To retrieve any sensitive data, you'd need to provide an app/user token, which is generated on the client’s side. There's no way to make data on the client's side completely secure.

You can improve your app's security by using an environment variable to inject the app secret into your code. That way, the secret isn't visible in your code.