Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Html
<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>

...

Info

This Guide describes several options on how to collect logs from Android and iOS Collaboration applications. Collecting logs is a useful method for debugging of various issues.

Created: April 2018

Updated: July 2019

Permalink: https://confluence.wildix.com/x/7gFuAQ


Table of Contents

Introduction

...

In this Guide you can find description on how to collect logs from Android/ iOS devices in case you have any issues with mobile Collaboration.

Useful links:

Collecting logs from Android app

Starting from Android Collaboration Version 4.05.22, it it possible to capture logs right off you mobile device.

To gather logs from Android app, follow the next steps:

Step 1. Install adb on you PC

Android Debug Bridge (adb) is a command-line tool that allows you to communicate with your device. As it is included in the Android SDK Platform-Tools package, you need to install this package.

...

Note: If you use MacOS, you can skip downloading and install the package via Terminal:

  • First, install Homebrew (package management software) using the following command:

Code Block
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Install Android SDK Platform-Tools with this command:

Code Block
brew cask install android-platform-tools

...

To use adb tool with your Android device connected over USB, you need to enable USB debugging option in the device system settings, under Developer options menu.

On Android 4.2 and higher, Developer options menu is hidden by default. To make it visible:

  • Go to Settings -> About phone and tap Build number seven times. You will see a pop-up message  "You are now a developer"

  • Return to Settings -> Additional settings and find Developer options menu

  • Allow USB debugging by tapping OK

Note

Note: On some Android devices, Developer options menu might be located or named differently. Please consult the documentation of your Android device to reveal the menu.

Step 3. Launch collecting of logs

After you enable USB debugging and connect you device to PC, use the following commands (depending on your OS) to launch collecting of logs. The separate file with logs will be created. 

  • On MacOS (execute the command in Terminal):
Code Block
adb logcat -v time > android-logs.txt

...

Note: On MacOS you can also perform log grabbing without creating a separate file, right in Terminal:

Code Block
adb logcat -v time
  • On Windows (execute the command in cmd: press "Win + R", type cmd, press Enter):
Code Block
C:\Users\user>D:\platform-tools\adb.exe logcat -v time > D:\android-logs.txt
Note

Note: When you connect the device, the system asks your permission to accept an RSA key that allows debugging through your computer. This helps to protect the device by ensuring that USB debugging cannot be executed without your permission.

...

  • Reproduce the issue

  • Copy logs from logcat tabs

  • To stop collecting logs, disable USB debugging option in your device's settingsGo to Settings -> Advanced and enable Debug option: 


  • Reproduce the issue
  • Return to Settings -> Advanced and tap Send (appear after enabling Debug option):


  • Select an email service ->  email template with the attached logs is automatically created

  • In the Subject field you need to describe the current behavior of the application and fill in information about your device model, Android version and Collaboration mobile version

  • Change/ add new recipients if needed and tap Send to forward the report:


Warning

Important! After the report with logs is sent, you need to disable Debug option.

Collecting logs from iOS apps 

Starting from iOS Collaboration Version 6.0.35105, it it possible to capture logs right off you mobile device.

To capture logs from iOS app:

  • Go to Settings -> Advanced and enable Debug option:



  • Reproduce the issue

  • Return to Settings -> Advanced  and tap Send (appears after enabling Debug option):



  • Email template with the attached logs is automatically created

  • In the Subject field you need to describe the current behavior of the application and fill in information about your device model, iOS version and Collaboration mobile version

  • Change/ add new recipients if needed and tap Send to forward the report:



Warning

Important! After the report with logs is sent, you need to disable Debug option.

Check / remove push notification subscription on Android/ iOS app

...