Устранение неполадок пакета SDK для macOS

  • Статья

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Проблемы во время установки

  1. В консоли найдите журнал утверждений с сообщением "Пакет SDK центра приложений настроен успешно". Это позволяет убедиться, что пакет SDK успешно настроен.
  2. Если вы используете Cocoapods для интеграции Центра приложений в приложение macOS и вызываете ошибку с сообщением " , CocoaPods - Unable to find a specification for AppCenterвыполните команду pod repo update , чтобы обновить локальный репозиторий Cocoapods, а затем снова запустить pod install .
  3. Если вы интегрируете двоичные файлы пакета SDK вручную, убедитесь, что модули включены для проекта.

Данные аналитики не отображаются на портале.

  1. Убедитесь, что модули SDK интегрированы правильно.

  2. Убедитесь, что вместе с вызовом метода включен правильный start:withServices: секрет приложения. Вы можете скопировать точный start:withServices:код, открыв приложение на портале и перейдя на страницу начало работы.

  3. Если вы хотите просмотреть журналы, отправляемые на серверную часть, измените уровень журнала на Подробный в приложении, и пакет SDK выведет журналы на консоль. Вставьте следующий вызов перед запуском пакета SDK:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

    AppCenter.logLevel = .verbose

    Убедитесь, что в журналах отображается сообщение "Пакет SDK центра приложений настроен успешно" (на уровне журнала INFO), а затем проверка, если отображаются журналы HTTPS-запросов.

  4. Убедитесь, что устройство подключено к Интернету и приложение имеет доступ к Интернету.

    Примечание

    Если приложение использует песочницу приложений, необходимо настроить возможность разрешить входящие (серверные) и исходящие (клиентские) подключения, чтобы разрешить приложению доступ к Интернету. Xcode 9 включает песочницу приложения по умолчанию, но возможности для входящих и исходящих подключений необходимо задать явно.

    Выберите проект в навигаторе проекта, перейдите на вкладку Возможности и, если приложение использует песочницу, добавьте возможности для входящих и исходящих подключений.

  5. Иногда для отображения журналов на портале может потребоваться несколько минут. Подождите некоторое время, если это так.

  6. Чтобы проверка, получила ли серверная часть Центра приложений ваши данные, перейдите в раздел Поток журнала в службе Аналитики. События должны отображаться после отправки.

Сбои не отображаются на портале.

  1. Убедитесь, что модули SDK интегрированы правильно.

  2. Убедитесь, что вместе с вызовом метода включен правильный start:withServices: секрет приложения. Вы можете скопировать точный start:withServices: код, открыв приложение на портале и перейдя на начало работы страницу.

  3. Перезапустите приложение после сбоя. При сбоях Центра приложений журнал сбоев будет пересылаться только после перезапуска приложения. Кроме того, пакет SDK не будет пересылать журналы сбоев, если вы подключены к отладчику. Убедитесь, что отладчик не подключен при сбое приложения.

  4. Если вы хотите просмотреть журналы, отправляемые на серверную часть, измените уровень журнала на Подробный в приложении, и пакет SDK выведет журналы на консоль. Вставьте следующий вызов перед запуском пакета SDK:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

    AppCenter.logLevel = .verbose

    Убедитесь, что в журналах отображается сообщение "Пакет SDK центра приложений настроен успешно" (на уровне журнала INFO), а затем проверка, если отображаются журналы HTTPS-запросов.

  5. Не используйте другие библиотеки, которые предоставляют функции отчетов о сбоях. В приложение можно интегрировать только один пакет SDK для отчетов о сбоях.

  6. Убедитесь, что устройство подключено к Интернету и приложение имеет доступ к Интернету.

    Примечание

    Если приложение использует песочницу приложений, необходимо настроить возможность разрешить входящие (серверные) и исходящие (клиентские) подключения, чтобы разрешить приложению доступ к Интернету. Xcode 9 включает песочницу приложения по умолчанию, но возможности для входящих и исходящих подключений необходимо задать явно.

    Выберите проект в навигаторе проекта, перейдите на вкладку Возможности и, если приложение использует песочницу, включите входящие и исходящие подключения.

  7. Иногда для отображения журналов на портале может потребоваться несколько минут. Подождите некоторое время, если это так.

  8. Если вы хотите проверка, если пакет SDK обнаружил сбой при следующем запуске приложения, можно вызвать API, чтобы проверка, произошел ли сбой приложения в последнем сеансе и отображает ли оповещение. Вы также можете расширить обратный вызов, didSucceedSendingErrorReport чтобы узнать, был ли он успешно отправлен на сервер.

  9. Чтобы проверка, что серверная часть Центра приложений получила сбой, перейдите в раздел Поток журнала в службе Аналитики. Ваши сбои должны появиться там после отправки.

Защита значения секрета Центра приложений

— app_secret это идентификатор вашего приложения. Он должен знать, к какому приложению применяется трафик, и его нельзя использовать для получения или изменения существующих данных. Если ваш app_secret объект подвержен риску, самый большой риск заключается в отправке неверных данных в приложение, но это не повлияет на безопасность данных.

Чтобы получить конфиденциальные данные, необходимо предоставить маркер приложения или пользователя, который создается на стороне клиента. Невозможно обеспечить полную безопасность данных на стороне клиента.

Вы можете повысить безопасность приложения, используя переменную среды для внедрения секрета приложения в код. Таким образом, секрет не отображается в коде.