Skip to content

Commit

Permalink
Update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
swift-kim committed May 24, 2024
1 parent fc554a7 commit fca9a5d
Show file tree
Hide file tree
Showing 11 changed files with 34 additions and 51 deletions.
9 changes: 6 additions & 3 deletions doc/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,16 @@ The following commands from the [Flutter CLI](https://flutter.dev/docs/reference
Flutter build command. See `flutter-tizen build -h` for all available subcommands.

```sh
# Build a TPK for TV devices.
flutter-tizen build tpk --device-profile tv
# Build a TPK in release mode and sign with an active profile.
flutter-tizen build tpk

# Build a TPK and sign with a certificate profile named "foo".
flutter-tizen build tpk --security-profile foo

# Build a TPK for TV emulator.
# Build a TPK for a non-TV device.
flutter-tizen build tpk --device-profile common

# Build a TPK for a TV emulator.
flutter-tizen build tpk --device-profile tv --debug --target-arch x86

# Build a Flutter module for adding to an existing Tizen app.
Expand Down
41 changes: 10 additions & 31 deletions doc/configure-device.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,22 @@
# Configuring Tizen devices for development

## Watch/TV
## TV

1. Make sure your host PC and target device are on the same network (connected to the same access point).
1. Make sure your host PC and TV are on the same network (connected to the same access point).

1. Enable the developer options.
1. Enable the developer mode.

- **[Watch]**: Open **Settings - About watch - Software**, tap **Software version** several times, and make sure **Debugging** is turned on. If you still see the message _Debugging is turned off_, tap _Debugging_ in the text to turn it on.
1. Open **Apps** and enter the number **12345** using the remote control or on-screen number pad.

![About watch](images/watch-developer-option-1.png) ![Software version](images/watch-developer-option-2.png) ![Debugging mode](images/watch-developer-option-3.png)
![Apps](images/tv-developer-option-1.png)

If you are connecting for the first time, make sure to disable **Bluetooth** and set **Wi-Fi** to **Always on**.
1. Set **Developer mode** to **On**, enter the IP address of the host PC, and press **OK**.

![Wi-Fi Always On](images/watch-developer-option-4.png)
![Enter IP address](images/tv-developer-option-2.png)

To find out the device IP address, go to **Settings - Connections - Wi-Fi - Wi-Fi Networks - (access point name)**.
1. Restart the TV. You will see **Develop Mode** enabled in **Apps** after the TV restarts.

![Wi-Fi networks](images/watch-developer-option-5.png) ![Wi-Fi connected](images/watch-developer-option-6.png) ![IP address](images/watch-developer-option-7.png)

- **[TV]**: Open **Apps**, enter **12345** using the remote control or on-screen number pad, set **Developer mode** to **On**, enter the host IP address, and press **OK**. You will see **Develop mode** enabled in **Apps** after the TV restarts.

![Apps](images/tv-developer-option-1.png)

![Enter IP address](images/tv-developer-option-2.png)

![Develop mode enabled](images/tv-developer-option-3.png)
![Develop mode enabled](images/tv-developer-option-3.png)

1. Find the path to `sdb` and add it to your PATH. For example, if you're using Linux or macOS and Tizen Studio has been installed to the default location, run:

Expand Down Expand Up @@ -142,20 +134,7 @@ You need a Linux PC (for flashing), a Raspberry Pi 4 board, and a micro SD card
failed to connect to 192.168.0.101:26101
```

Make sure the target device and the host PC are on the same network.

- Watch: Make sure Bluetooth is turned off and restart the device.
- TV: Make sure you have entered the host IP address correctly in the Developer mode configuration.

- #### Device unauthorized

```sh
$ sdb devices
List of devices attached
192.168.0.101:26101 unauthorized <unknown>
```

Check the confirmation dialog on the device and approve the connection.
Make sure the target device and the host PC are on the same network. Make sure the host IP address is entered correctly in the developer mode settings (TV).

- #### Device offline

Expand Down
5 changes: 2 additions & 3 deletions doc/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,8 @@

```
$ flutter-tizen devices
1 connected devices:
Tizen T-samsung-8.0-x86 (mobile) • emulator-26101 • flutter-tester • Tizen 8.0 (emulator)
Found 1 connected device:
Tizen T-samsung-8.0-x86 (mobile) • emulator-26101 • flutter-tester • Tizen 8.0 (emulator)
```

## Test drive
Expand Down
Binary file removed doc/images/watch-developer-option-1.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-2.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-3.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-4.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-5.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-6.png
Binary file not shown.
Binary file removed doc/images/watch-developer-option-7.png
Binary file not shown.
30 changes: 16 additions & 14 deletions doc/install-tizen-sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,18 +11,18 @@ After installing Tizen Studio, the _Package Manager_ window will automatically p

![Tizen Package Manager](images/package-manager.png)

- **Required**
- _[Tizen SDK tools] - [Native CLI]_
- _[Tizen SDK tools] - [Baseline SDK] - [Certificate Manager]_
- _[Extension SDK] - [IOT-Headed-6.0] - [Advanced] - [Native app. development (CLI)]_
- _[Extension SDK] - [Samsung Certificate Extension]_
- [Tizen SDK tools] - [Native CLI]
- [Tizen SDK tools] - [Baseline SDK] - [Certificate Manager]
- [Extension SDK] - [IOT-Headed-6.0] - [Native app. development (IDE)]
- [Extension SDK] - [Samsung Certificate Extension]

- **Optional**
- _[8.0 Tizen] - [Emulator]_
- _[6.0 Mobile] - [Advanced] - [Native app. development (CLI)]_
- _[Extension SDK] - [TV Extensions-x.x] - [Emulator]_
To enable emulator support, install the following additional packages.

You can also install these packages from the command line by following the instructions of `flutter-tizen doctor -v` after installing flutter-tizen.
- [8.0 Tizen] - [Emulator]
- [6.0 Mobile] - [Native app. development (IDE)]
- [Extension SDK] - [TV Extensions-x.x] - [Emulator]

Note: The packages can also be installed using the command line interface by following the instructions of `flutter-tizen doctor -v` after installing flutter-tizen.

If you cannot see extension packages in the _Extension SDK_ tab, click the configuration button (⚙️) and make sure you are using the latest official distribution.

Expand All @@ -36,15 +36,17 @@ If you installed emulator packages in the previous step, you can use _Emulator M

To launch an emulator, select a device and press _Launch_. You can also use the [`flutter-tizen emulators`](commands.md#emulators) command to launch an emulator without _Emulator Manager_.

Note: If you are using Windows on an AMD-based system, you cannot launch Tizen emulators because _Emulator Manager_ depends on _Intel HAXM_. For more information on HW virtualization, see [Tizen Docs: Increasing the Application Execution Speed](https://docs.tizen.org/application/tizen-studio/common-tools/emulator/#increasing-the-application-execution-speed).
Note: Launching a Tizen emulator requires HW virtualization (Intel VT-x/AMD-V) support. For more information, see [Tizen Docs: Increasing the Application Execution Speed](https://docs.tizen.org/application/tizen-studio/common-tools/emulator/#increasing-the-application-execution-speed).

## Create a certificate profile

## Create a Tizen certificate
To install your app on a Tizen device or publish it to the TV App Store, you need to sign the app with a valid certificate. Use _Certificate Manager_ (GUI), or the [`tizen certificate/security-profiles`](https://docs.tizen.org/application/tizen-studio/common-tools/command-line-interface) command (CLI) to create a certificate profile.

To install your app on Tizen devices or publish on _TV App Store_, you need to sign the app with a valid certificate. Use _Certificate Manager_ (GUI), or the [`tizen certificate/security-profiles`](https://docs.tizen.org/application/tizen-studio/common-tools/command-line-interface) command (CLI) to create a Tizen or Samsung certificate.
Choose the _Samsung_ profile type instead of _Tizen_ if you're not sure.

![Certificate types](images/certificate-types.png)

Choose Tizen certificate if you only want to test your app on emulators. Otherwise, choose Samsung certificate and specify DUIDs of your devices when creating a distributor certificate.
You should specify the DUID of your device (including emulator) when creating a distributor certificate. The DUID is automatically added to the list when the device is connected to the PC.

![Specify DUIDs](images/certificate-enter-duid.png)

Expand Down

0 comments on commit fca9a5d

Please sign in to comment.