Managing and Connecting Devices for Testing

The Connection Explorer view shows the devices connected to the system. A list of connected devices is available in tree view after connecting a device or launching a Tizen emulator. The Connection Explorer view provides the following actions for the connected devices:

Show a list of connected devices and connect devices for running and debugging the application.

Provide file operations on connected devices.

Send or receive files between the Project Explorer and Connection Explorer views by dragging and dropping.

Explore the file system on the connected devices.

Launch the Emulator Manager to handle multiple emulator instances.

Figure: Connection Explorer view

Running and Debugging the Application with Devices

You can test Tizen applications with connected devices in the following ways:

Testing applications on a physical device connected to the host system: -

Connect your device to the host system with a USB cable. The device icon () is displayed in the Connection Explorer view.
Select the device in the Connection Explorer view. It is ready to be run and used to test your project.

Testing applications on an emulator that emulates a real device as a software component installed on the host computer -

To start the emulator:

Click the Emulator Manager icon in the Connection Explorer view toolbar, select an emulator in the Emulator Manager, and click Launch. -
The emulator icon () is displayed in the Connection Explorer view after the emulator boots successfully.
Select the emulator device in the Connection Explorer view. It is ready to be run and used to test your project.

Testing applications on a remote device -

To connect to the remote device:

- -

In the Connection Explorer view toolbar, click the Remote Device Manager icon (). -
When the Remote Device Manager is launched, it automatically starts to scan for nearby remote devices:
-
- If a remote device exists on the host system's subnet, the remote device information is registered to the Remote Device Manager automatically.
- To add remote device information, click New. -
  In the dialog box, enter the Name, IP, and Port of the remote device.
  - -
  To modify the remote device information later, select the device in the Remote Device Manager, click Edit, and modify the Name, IP, and Port in the dialog box.
-
In the Remote Device Manager, select a remote device.
Click Connect.
In the Connection Explorer view, select the device. It is ready to be run and used to test your project.

When testing is finished, disconnect the remote device by selecting the device in the Remote Device Manager and clicking Disconnect. To remove the remote device from the Remote Device Manager, select the device in the Remote Device Manager and click Delete.

Transferring Files to Devices

You can transfer files between the connected devices and the host system:

To transfer a file from a connected device to the host file system, pull the selected file to the desired host system path.

To transfer a file from the host file system to a connected device, push the selected file to the desired connected device path.

Checking Logs with Log View

This topic explains how to insert logging methods to your code and check the logs of your application in the Log view.

You can insert logging methods to your code and check the logs of your application in the Log view.

Viewing Logs in Log Tabs

- -

By default, the Log view is located at the bottom of the Native perspective. If you want to open the Log view manually, go to Window > Show View > Other > Log in the Tizen Studio menu.

The Log view helps you debug your application by capturing all the events logged by the platform and your application. The Log view shows the logs through the dlog logging service. The service consists of the dlogutil and dlog library. You can also see logs with the dlogutil command in the CLI environment, and create log entries with the dlog library.

When a device is connected, a device log tab is automatically created in the Log view. You can create additional tabs for a device, and you can set different filters for each tab. Tabs for disconnected devices are shown as inactive, and are reactivated when the device is reconnected.

Figure: Log view

Log view

Creating a Log Message

You can create a log message in your application with the dlog library. Before using the dlog library, make sure you know which priorities and tags to use and how to send the message to the log device. With appropriate properties and tags, it is easy to filter and check messages.

For more information, see the System Logs guide.

Adding and Removing the Log Tab

Each device has at least 1 default log tab associated with it. If a device is connected, the default log tab is not editable or removable. However, you can add a new log tab with more filtering options. The added log tabs are editable and removable.

Each log tab contains a toolbar and a log table. The log table lists log messages in chronological order, and this order cannot be modified. Each log message contains the Time, Level (priority level of the log message), Pid (process ID), Tid (thread ID), Tag (identification of the log message source), and Message fields, and you can create filters for each field.

You can perform a variety of actions in the Log view:

Adding a log tab: -
1. Click the Add LogTab button ().
2. Enter the tab name in the Name field and select a device in the Device list.
3. Enter the search keywords in the Tag, Pid, and Message fields.
4. Click OK. -
-
Removing a log tab: -
1. Click the log tab to be removed.
2. Click the Remove LogTab button ().
-

Understanding and Filtering Logs

The log table consists of the following fields:

Time: log time
Level: priority level indicates the urgency of the log message
Pid: process ID
Tid: thread ID
Tag: identification of the log message source
Message: log message
Creating a new log tab +
You can create a new log tab in 2 ways:
+
- Right-click a device in the Device Manager and select Add log tab. Enter a name for the tab and click OK.
- Select a device in the Device Manager and click + in the Log view. Enter a name for the tab and click OK.
+
Editing a log tab name +
When a device is connected and a log tab is automatically created, the default name of the new tab is the device ID. You can edit that name, and the names of the tabs you have manually created yourself.
+
To edit the log tab name, click the Edit Tab button (). Enter a new name for the tab and click OK.
+
Removing a log tab +
You can either delete a single tab, or delete all tabs related to a device.
+
- To delete a single tab, click the X next to the log tab name.
- To delete all tabs for a device, right-click the device in the Device Manager and select Delete log tabs. Confirm the deletion by clicking OK.
+
+ Note + Any filters created for a log tab are deleted when the tab is removed. +
+
Filtering a log messages +
You can filter log messages based on the table columns:
+
- To filter log messages based on the Level, Pid, Tid, or Tag columns, click the icon next to the column name, select 1 or more values you want to show, and click OK.
- To filter log messages based on the Message column, enter the Message field string you want to search for to the input field at top of the Log view.
+
Clearing logs +
To clear all log messages from a tab, click the Clear Logs button ().
+
Exporting logs +
To export logs to a file, click the Export Logs button (), select the file storage location and file name for the exported log, and click OK.
+
+ Note + If you have filters applied to a log tab, only messages that match those filters are exported. If you want to export the complete log, remove all filters before exporting. +
+

Figure: Log table fields

Log view

- -

In the log table, you have the following options and functions:

- -

Log level filtering option -
In the Log view, you can filter the log messages using the V (verbose), D (debug), I (info), W (warning), E (error), and F (fatal) buttons to show the log messages matching the selected type.
Keyword filtering option -
You can filter the log messages by selecting one of the PID, Tag, and Message options, or entering keywords in the bottom of the Log view. The keywords must be separated by a space or a comma.
Scroll lock -
The log table shows the latest logs by default. While the application is running, the log table scrolls as new logs are added to the table. To stop the table from scrolling while you are checking a specific log, click the Scroll Lock button ().
Clearing the table -
You can remove all log messages from the log tab by clicking the Clear the log button ().
Exporting logs to a file -
You can export the current log messages in the log tab and save them as a log file by clicking the Export the log button ().
-

- diff --git a/org.tizen.studio/html/images/conn_explorer_connection.png b/org.tizen.studio/html/images/conn_explorer_connection.png deleted file mode 100644 index f39f12c..0000000 Binary files a/org.tizen.studio/html/images/conn_explorer_connection.png and /dev/null differ diff --git a/org.tizen.studio/html/images/conn_explorer_icon1.png b/org.tizen.studio/html/images/conn_explorer_icon1.png deleted file mode 100644 index f9c33e9..0000000 Binary files a/org.tizen.studio/html/images/conn_explorer_icon1.png and /dev/null differ diff --git a/org.tizen.studio/html/images/conn_explorer_icon2.png b/org.tizen.studio/html/images/conn_explorer_icon2.png deleted file mode 100644 index f789fc9..0000000 Binary files a/org.tizen.studio/html/images/conn_explorer_icon2.png and /dev/null differ diff --git a/org.tizen.studio/html/images/conn_explorer_icon3.png b/org.tizen.studio/html/images/conn_explorer_icon3.png deleted file mode 100644 index e1105cc..0000000 Binary files a/org.tizen.studio/html/images/conn_explorer_icon3.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view.png b/org.tizen.studio/html/images/log_view.png index fab95ef..e48a1ef 100644 Binary files a/org.tizen.studio/html/images/log_view.png and b/org.tizen.studio/html/images/log_view.png differ diff --git a/org.tizen.studio/html/images/log_view_clear_logs_icon.png b/org.tizen.studio/html/images/log_view_clear_logs_icon.png new file mode 100644 index 0000000..8a2a33c Binary files /dev/null and b/org.tizen.studio/html/images/log_view_clear_logs_icon.png differ diff --git a/org.tizen.studio/html/images/log_view_edit_tab_icon.png b/org.tizen.studio/html/images/log_view_edit_tab_icon.png new file mode 100644 index 0000000..b928718 Binary files /dev/null and b/org.tizen.studio/html/images/log_view_edit_tab_icon.png differ diff --git a/org.tizen.studio/html/images/log_view_export_logs_icon.png b/org.tizen.studio/html/images/log_view_export_logs_icon.png new file mode 100644 index 0000000..53a1f7b Binary files /dev/null and b/org.tizen.studio/html/images/log_view_export_logs_icon.png differ diff --git a/org.tizen.studio/html/images/log_view_fields.png b/org.tizen.studio/html/images/log_view_fields.png deleted file mode 100644 index a2d380d..0000000 Binary files a/org.tizen.studio/html/images/log_view_fields.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view_icon.png b/org.tizen.studio/html/images/log_view_icon.png deleted file mode 100644 index 804345d..0000000 Binary files a/org.tizen.studio/html/images/log_view_icon.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view_icon_clear.png b/org.tizen.studio/html/images/log_view_icon_clear.png deleted file mode 100644 index 7cbaf53..0000000 Binary files a/org.tizen.studio/html/images/log_view_icon_clear.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view_icon_export.png b/org.tizen.studio/html/images/log_view_icon_export.png deleted file mode 100644 index a84de55..0000000 Binary files a/org.tizen.studio/html/images/log_view_icon_export.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view_icon_lock.png b/org.tizen.studio/html/images/log_view_icon_lock.png deleted file mode 100644 index 2b2512f..0000000 Binary files a/org.tizen.studio/html/images/log_view_icon_lock.png and /dev/null differ diff --git a/org.tizen.studio/html/images/log_view_icon_remove_tab.png b/org.tizen.studio/html/images/log_view_icon_remove_tab.png deleted file mode 100644 index f258d14..0000000 Binary files a/org.tizen.studio/html/images/log_view_icon_remove_tab.png and /dev/null differ diff --git a/org.tizen.studio/html/index.htm b/org.tizen.studio/html/index.htm index cc58121..78b5543 100644 --- a/org.tizen.studio/html/index.htm +++ b/org.tizen.studio/html/index.htm @@ -132,7 +132,6 @@

Managing and Connecting Devices for Testing

Running and Debugging the Application with Devices

Transferring Files to Devices

Configuring Preferences

Checking Logs with Log View

Viewing Logs in Log Tabs

Creating a Log Message

Adding and Removing the Log Tab

Understanding and Filtering Logs