faq q01. if i create a watch face using watch face studio, is it supported on all wear os watch devices? watch face studio is compatible with all wear os watch devices running api level 30 and higher. if you create a watch face in watch face studio, you can use it on all wear os watch devices, regardless of manufacturer. however, because of limitations with deprecated apis, your watch face may not be available on devices that are still using deprecated apis. the galaxy watch studio serves tizen’s galaxy watch 1, 2, and 3. q02. does watch face studio support all types of watch face shapes, including circular and square? in watch face studio, the watch shape is set to a circle by default. to support other watch face shapes, disable the apply circular crop option in the watch face canvas properties. when circular crop is disabled, the watch face shape is determined by the user’s device. to ensure watch face components display correctly, avoid placing components directly on the edges of the watch face. the image can shift on some devices to prevent screen burn-in. watch face studio creates a project with a single screen resolution, but the created watch face supports all device resolutions. q03. how can i design my watch face to save battery? you can reduce battery usage through the following strategies: use darker colors on the watch face. make sure the images are fitted to the screen. make sure you have removed all unused layers before building the watch face package. for more information, see performance tips. q04. how can i improve the performance of my watch face? using too many components in your watch face can degrade the performance of the watch face and consume the device battery more. to optimize the use of components: make sure fewer than 8 complications are visible in both ambient and normal modes. make sure there are no hidden layers in either ambient or normal modes. q05. how does my watch face work in always-on (ambient) mode? the second hand is not supported in ambient mode. design your watch face to hide the second hand in ambient mode. the on-pixel ratio (opr) varies between device models. to find the opr for a specific device, check the device specification. to examine the on-pixel performance of your design in ambient mode for various device shapes, in the run preview, select analyze. you can also analyze the on-pixel performance for circular devices when you use the run on device and publish features in watch face studio. q06. how can i enable users to customize their watch face? to enable watch face customization, define themes and styles for the watch face in the style property window. the user can select from the themes and styles you have defined. you can define a theme color palette and apply those colors to the component layers. you can also implement multiple images for the analog hands, image, multimedia, and index components. remember to give each component and style a clear, descriptive name. the names appear when the user uses the customize mode to personalize their watch face. you can also implement localized component names using text ids. for more information, see project settings. q07. what is the difference between the step counter tag expressions [sc], [sc_per], and [sc_goal]? the [sc] tag is the measured step count. the [sc_goal] tag represents the step goal. the user’s step goal can be synchronized from a supported health application, or you can define a step goal for the watch face. to configure the step goal for your watch face, in wfs, go to file > project > settings > health. the [sc_per] tag is the percentage of the step goal achieved, automatically calculated from the step count and step goal. q08. how do i sell my watch face in a region that is not supported by the play store? watch faces can be sold in unsupported countries through the device manufacturer’s own app store. for example, watch faces for galaxy watch can be sold through galaxy apps. for more information, see galaxy store seller portal. different app stores can support different file types for watch faces, such as apk or aab. you must create the appropriate watch face package for each store. q09. why can't i find the 'enable debugging over the bluetooth' setting in galaxy wearable application on my phone? check that your wearable device supports bluetooth debugging. debug over bluetooth is not supported on wear 3 devices. for more information, see debug over bluetooth. q10. why can’t i use lottie multimedia files on my watch face anymore? lottie files are no longer supported since watch face studio version 1.4.13. you must replace them with animations in a supported format, such as webp or animated gif. q11. how does the step goal "sync to device" feature work? the sync to device feature enables your watch face to use the step goal defined by the user on their device’s health application. it is supported on watch devices running api level 33 and higher (wear 4 and later). on wear 3 devices, because sync to device is not supported, the step goal is fixed to 6000. if you want to set a different step goal for wear 3 devices, you must create a separate watch face version for wear 3, disable sync to device, and define the step goal directly. q12. why are some heart rate tag expressions and features not supported for my watch face? some tag expressions and features related to measuring heart rate on wear os watch devices running api level 30 are not supported by watch face studio v1.4.13. however, wfs supports synchronizing the measured heart rate value with the value displayed on the screen. on wear os watch devices running api level 33 and higher and galaxy watch devices for wear os powered by samsung, the open app feature supports opening the health application to view heart rate information on those devices. q13. why can't i group a complication slot with other components or combine multiple complications? in watch face studio, complications must be implemented independently. they cannot be grouped with or be part of another element. complications can only contain elements within them.

watch face studio release notes introduction release version: 1.4.13 release date: may 10, 2023 notethe project file created in a higher version of watch face studio is not allowed to open in an older version for compatibility. we recommend that you download the latest version. change history watch face studio 1.4.13 (beta) newmay 10, 2023 0. common support watch faces for watch devices that run wear os targeting api level 30 and higher. support watch face format of wear os. support the user guide link in about menu. 1. project management support thumbnail of watch face in case of circular crop off. 2. edit & properties support complication slot way that suppport multi types in a slot. support text id for localized text which is displayed on device such as style name and used in talkback case. support to display current on-pixel ratio (opr) in run tab. support to stop in first on-pixel ratio (opr) error situation while analyzing. removed lottie format for multimedia. removed hr measurement including tag expression, action and interval in setting. removed chin shape in run preview window. 3. etc change version code policy. (wfs user allow the specific range 0~999,999) support to choose build type(aab, apk, aab+apk) to reduce build time. fixed minor issues. watch face studio 1.3.13jan 4, 2023 fixed javascript error while opening watch face studio. watch face studio 1.3.12nov 15, 2022 1. edit & properties add inactive bar state in conditional line. fixed style order issue in customization editor. fixed to enhance color chip quality in customization editor. fixed to convert from string type to number type before arithmetic comparison. fixed to reset msec when user changes time with time slider. fixed to hide all components in complication when provider is set to empty. fixed to remove unwanted stroke outside of run preview. fixed to disable click event if media file path is undefined. fixed to disable double click event on interaction icon in customization editor. fixed to update style information and element together in customization editor. 2. etc fixed to update world clock properly in tag expression. fixed minor bugs and gui improvements. watch face studio 1.3.8 (beta)oct 12, 2022 1. project management add sample projects and change sample images. improve my workspace to display all project files in workspace. 2. edit & properties support style set. add 'event' condition including unread notification and low battery in conditional line. add some conditions for unread notification and locale in run tab. add new tag expression. (unread_nc) add "islamic-umalqura" in local calendar. improve theme color from single to multi color. improve time zone / local calendar / language in digital clock component and tag expression. improve style to import multiple resources by file selector. improve color picker to show current/new and recently used color. improve performance when multiple multimedia/animation components are used in timeline condition. 3. etc fixed build fail issue with characters not allowed in project name. fixed "run on device" to operate normally when connecting lan cable between pc and wifi ap fixed time update issue after changing time zone in aod. fixed wrong [ampm_po] result for ja_jp locale. fixed to consider alpha value of index component in import gwd resource. fixed to support horizontal scroll with shift + mouse wheel in conditional line. watch face studio 1.2.7aug 23, 2022 fixed animation lag issue. fixed description of tag expression asin(num). watch face studio 1.2.6jul 7, 2022 fixed crash issue when attempting to build a project created in an older versions of watch face studio 1.1.0. fixed value conversion error of hands component imported from gwd. fixed animation frame count error. fixed numberformat() error of tag function. fixed description of tag function deg(num). watch face studio 1.2.5jun 23, 2022 1. project management & common support starred project and sort option. provide sample projects. remove new project page. add system theme mode in preferences dialog. add canvas circular crop option in project setting dialog. 2. component add multimedia style and tap action. add watch face canvas property. 3. edit & properties add new tag expressions. functions for asin(num), acos(num), atan(num), deg(num), rad(num), pow(base, exponent) 4. etc improve build time. fixed digital clock component to follow language setting in device. fixed icon of the complication to be updated well in device. fixed text with "sync to device" font setting to follow system font in device. fixed complication date and time issue to be removed after emptying the complication slot. temporarily disabled the feature that showing watch face after device boot with lock. it will be enabled again after platform upgrade. support 'multiple instances' feature for new wear os version. watch face studio 1.1.14apr 1, 2022 fixed preview image bug that hands component only shows up. watch face studio 1.1.13mar 31, 2022 replaced all fonts provided by text component. fixed blank warning dialog issue after build. fixed group ordering issue. fixed jumping time issue on watch. fixed group resize issue on watch. deleted '3 digit' in the description of tag [mon_s]. removed android.permission.query_all_packages permission. fixed tap animation lag when using multiple mask elements on watch. update open source license. (sil open font license) watch face studio 1.1.9feb 24, 2022 1. common provide version update notice. support dark theme for comfortable & relaxed use. support color label in layer. 2. component support mask. support multimedia. (webp, agif, lottie) 3. edit & properties improve properties. (bitmap font, curved text, progressbar) improve animation panel. (loop times, frame count) support trigger for animation and multimedia component. support bitmap font management in setting. support image appearance for image. support loop, copy, paste in conditional line. 4. style support grid view. support reorder item. increase the number of each item. 5. etc provide editor tutorial on watch. update open source license. watch face studio 1.0.12nov 19, 2021 fixed known issue: editable complications that support various layouts, such as "icon+text" and "title+text" of short text complication, display only one layout. watch face studio 1.0.11nov 17, 2021 known issue: editable complications that support various layouts, such as "icon+text" and "title+text" of short text complication, display only one layout. 1.build use workspace folder to save build output. provide previously used build information in build dialog. 2. edit & properties support functions in the tag expressions. round(num), floor(num), ceil(num), sin(num), cos(num), tan(num), abs(num), clamp(num, min, max), numberformat(form, num) support multiple image selection in add component. change image max size to 2250(450*5) in import image. updated naming rule for style. fixed minor bugs. 3. preview & run tap action shows visual touch feedback. improved smoothness of sweep animation for second hand. fixed hr to be measured even in devices without body-off sensor. 4. terms of service change the coverage of 'watch face' like 'for android watch devices and samsung mobile devices'. watch face studio 1.0.3sep 16, 2021 1.build support apk build output for uploading watch faces to galaxy apps. added logic to check valid characters for a package name. package name can contain only alphanumeric characters and the underscore. fixed crash issue when using non-ascii character for a project name. 2. properties removed number type in index setting. fixed undo issue on dimension, curved-text in properties. added new tag expressions. [tmzn_ofs_with_dst], [hr_measure_result] 3. preview & run fixed tag expression issues. [utc_ts], [week_in_month], [sc_per], [day_of_week], [hr_is_measuring] fixed locale and timezone issues. fixed theme color, angle position and gyro effect issues. fixed opacity issue in ambient mode. fixed transform tag issue in a group. fixed complication data issue from watch device. fixed bitmap font issue for custom string including zero. improved for smoother animation. improved power consumption in ambient mode. fixed minor issues. watch face studio 1.0.0aug 11, 2021 initial version

apply conditional lines on watch faces objective learn how to create a watch face that responds to time and notification using conditional lines in watch face studio. overview watch face studio is a graphic authoring tool that enables you to create and design watch faces for watches running on wear os. it offers a simple and intuitive way to add images and components, and to configure the watch movement without any coding. watch face studio supports watch faces for the galaxy watch4 or newer version, and other watch devices that run on the same platform. conditional lines in watch face studio lets users easily control components and its behaviors on watch faces. you can make your watch faces change dynamically based on time, step-count, or battery using conditional lines. now, with the latest version of watch face studio, you can also set conditional lines based from events such as low battery, unread notification, or scenarios without any events. set up your environment you will need the following: watch face studio (latest version) galaxy watch4 or newer any supported wear os watch sample project here is a sample project for this code lab. download it and start your learning experience! conditional lines sample project (2.48 mb) start your project download the sample project file, and click open project in watch face studio. locate the downloaded file, then click open. apply conditional lines based on time using conditional lines in watch face studio, your watch face can visually change its design based on the time of the day. here, you can change the background image of the watch face based on certain time intervals by setting the timeline condition of two background images, named background_day and background_night. click the show/hide timeline icon to show the frame area. notice that there's a default conditional line based on time for every component. each conditional line is represented by a bar in the timeline and you can adjust it using the slider at the end of the bar. collapse the background group containing the two background images. in the timeline area of background_day, click on its bar and hover your mouse at the start of the bar. drag the start of the bar to 06:00:00h and drag the end of the bar to 18:00:00h. this sets the condition that background_day visually appears on the watch face from 6:00 am until 6:00 pm. tipto quickly navigate on the timeline, hold shift + mouse scroll. learn more about keyboard shortcuts, by referring to this guide. next, for background_night, set the first time condition from 00:00:00h to 06:00:00h by dragging its bar respectively. at the start of 18:00:00h, double-click at the timeline area to create a 2nd bar at that specific time. drag the end of the bar to 00:00:00h, at the rightmost part of the timeline. this makes background_night to appear conditionally from 6:00 pm until 6:00am on your watch face. now, it's time to check if your watch face responds correctly based on the time of the day. click show/hide run button to open the run panel in watch face studio. move the time control slider from 06:00:00h to 18:00:00h and the watch face should show background_day as its background. similarly, check if the watch face changes its background to background_night when the time is from 18:00:00h to 06:00:00h. set the unread notification event make your watch face change dynamically based on a specific device event. in this step, add an event for unread notifications on notification_envelope, an animation component included in the sample project. click + or add conditional line and select event. noteto remove conditional line icons such as the battery, steps, 12h/ 24h, or event, simply right-click on it and select remove. click show/hide event to start configuring the event-based conditional line for notification_envelope. on the notification_envelope layer, double-click on the event frame. in the warning window, click ok. in this case, all existing conditional frames for this layer are deleted. afterward, a bar is created for the event-based conditional line. noteeach layer responds to only one type of condition. next, drag the bar from no event to unread notification. noteno event is used if there is no condition set on either battery low or unread notification events. check if the notification_envelope animation component appears on your watch face whenever there's an unread notification. click play run preview and move the unread notification slider in the run panel. when the unread notification is set to a value of 1 or more, the animation component should visually appear on your watch face. test the watch face to test your watch face, you need to: connect a watch device to the same network as your computer. in watch face studio, select run on device. select the connected watch device you want to test with. if your device is not detected automatically, click scan devices to detect your device or enter its ip address manually by clicking the + button. notethe always-on display is already set in the project. to run the watch face successfully, you may need to configure its always-on display to avoid any error when you run on device. you're done! congratulations! you have successfully achieved the goal of this code lab. now, you can use conditional lines in watch face studio, all by yourself! if you're having trouble, you may download this file: conditional lines complete project (2.48 mb) to learn more about watch face studio, visit: developer.samsung.com/watch-face-studio

watch face studio (wfs) is an intuitive graphical tool that provides designers a means to design watch faces for the wear os smartwatch ecosystem without the need for coding. basic information on a watch face is typically presented as text, and watch face studio enables you to customize how the text is displayed. this article introduces three features you can use to enhance the text on your watch face design: tag expressions curved text bitmap fonts you can follow along with the demonstrations in this blog by downloading the sample project. tag expressions tag expressions enable you to create watch face components for which the rotation, placement, and opacity changes based on tag values. the tag values represent watch data, such as the date and time, battery status, sensor and health data, moon phase, and mathematical operations. for example, you can create a watch face that shows the date and time, and a progress bar that fills up each minute. this section describes how to implement this using tag expressions. to implement the dynamic watch face: create a text component. in the "properties" panel, select the text field text box. select the tags button that appears. figure 1: tags button to add the hour text, from the tag list, select [hour_0_11], then select done. figure 2: tags list similarly, to add the minutes text, create a text component with the [min] tag. to implement the progress bar for the seconds display: a. create a progress bar component. b. define its value as the [sec] tag and set its maximum value to 60. create text components for the date-related elements: [day_week_f] (day of the week), [mon_f] (name of the month), and [day_1_31_z] (day of the month). note : you can also display the weekday and month information as numbers, by using different tags. keep in mind that in watch face studio, sunday is the first day of the week. the following figure shows the progress bar on the watch face after some visual adjustments. figure 3: seconds progress bar on watch face for more examples of tag expression implementation, see the tag expressions code lab for watch face studio. curved text you can place text around a curve by selecting from predefined angular ranges, or by defining a specific start position and distance. you can also easily set the text direction. to place curved text around the top of the watch face: create a text component and define the text you want to display. in the "properties" panel, select apply curved-text. select ok. the curved text settings appear. in the "curving" fields, define the width and height of the circle or oval around which the text is to be placed. the width and height values are in pixels. for this demonstration, set both the width and height to 436. to place the text around the top of the watch face, in the "range" section, select the upper half circle. figure 4: configuring the curved text the following figure shows the curved text on the watch face after some visual adjustments. figure 5: curved text on a watch face note : you can also implement curved text on complications. bitmap font bitmap fonts enable you to replace information on the watch face, such as digits, symbols, and day of the week, with customized images. use different icons and images in the bitmap font to make your watch face more interesting. to implement icons for the am/pm tag: create a text component. in the "properties" panel, select the text field text box. select [ampm] from the tags list, and select done. figure 6: am/pm tag in the "text appearance" section, select bitmap font. open the "bitmap font setting" dialog. figure 7: bitmap font configuration in the "bitmap font setting" dialog, select the other tab. to add an image for a specific string, select + and browse to the image on your computer. do this for both the "am" and "pm" strings. to close the dialog, select ok. figure 8: adding a bitmap font image the watch face displays the selected images in place of the "am" and "pm" text strings. a watch face can have multiple bitmap fonts. you can add another bitmap font from the dropdown menu and apply different bitmap fonts to different text elements. figure 9: creating another bitmap font note : the sample project contains two bitmap fonts. conclusion watch face studio provides various text options for the watch face. the text customization features described in this blog can help you create an eye-catching watch face. resources for more information about watch face studio, see the watch face studio documentation. you can also visit the samsung developers forums, an active and friendly community where you can ask for and receive help with your application development. the samsung developers site has many resources for developers looking to build for and integrate with samsung devices and services. stay in touch with the latest news by creating a free account and subscribing to our monthly newsletter. visit the marketing resources page for information on promoting and distributing your android apps. to learn more about customizing your watch face, see also the design complications using watch face studio blog.

create a watch face using tag expressions objective learn how to create a watch face that responds based on the date, time, step count, heart rate, and battery level using tag expressions in watch face studio. in this code lab, you will start by creating a basic watch face with complications such as step count, heart rate, and battery level. later on, you will improve its functionalities and make it visually dynamic by utilizing tag expressions. overview watch face studio is a graphic authoring tool that enables you to create watch faces for wear os. it offers a simple and intuitive way to add images and components, and to configure the watch movement without any coding. watch face studio supports watch faces for the galaxy watch4 or newer version, and other watch devices that run on the same platform. tag expressions are conditions in watch face studio that allows you to customize watch face through dynamic configuration of its movement and data. set up your environment you will need the following: watch face studio galaxy watch4 or newer any supported wear os watch start your project create a new project and input project name. a blank studio will show upon clicking ok. add analog hands and index watch face studio allows you to add different components like text, image, shape, analog hands, and index in a watch face. for your watch to have the look and feel of an analog watch, add the following components: time > index (index_gentle) time > analog hands > minute (watch_min_gentle) time > analog hands > hour (watch_hour_gentle) you will see that the hands are moving automatically and in sync with the device time. select all the newly added components and click group. rename the group as group_analogtime. use a progress bar for seconds a component like progress bar can be used to show how much of the process is completed and how much is left. in this step, you will use it to show how far or close the next minute is. to use a progress bar as seconds: click add component and select progress bar. rename the component to seconds. move seconds behind group_analogtime. in properties of seconds, do the following: a. adjust the dimension (width and height) to 395. b. align the component to the center. c. drag the background slider to 0%. d. make sure that the type is a circular progress bar, otherwise change it. e. in range setting, change value to 0 and click tags beside it to open the tags window. type in [sec]. it means that the value from 0 will increment as the value of second increases. f. set max value to 59 since it is the maximum value of [sec]. notein this scenario, the progress bar seems to disappear in the canvas as the preview only use the base value, which is 0. however, you can see the component still present in run. format and position a digital clock in this step, you will learn how grouping works and affects its components. you will also learn how to format the date and time using tags. to format and position a digital clock, you need to: add a digital clock > time twice. rename them as hour and minute respectively. add a digital clock > date and rename the component as date. put them in one group and rename it as group_digitaltime. go to the properties of hour and change the text appearance to 80. do the same for minute. adjust the text size of date to 15. adjust the y placements of the individual components, so that they will look like the image below. when you make changes to a certain component, it won’t affect other components in the group. format hour to only show the time in hour: a. go to its properties and click tags button in text field. b. replace text field value with [hour_0_23_z] to show current hour with leading zero. do the same for minute but replace text field value with [min_z] to show current minute in an hour with leading zero. go to group_digitaltime placement properties and align it horizontally. after that, place it to the left. you will see the components adjusted as a group. utilize health features and battery level watch face studio also allows you to utilize data like step count, heart rate, and battery level. follow the steps below to show these real-time data using tags on texts or progress bar: battery level add a circular progress bar and rename the component as battery level. drag the background slider to 0%. go to value properties. replace the value to 0 and, in tags, input or choose [batt_per] to use current battery percentage as value. add a short text complication and rename it as battery icon. complications are set of components that can be handled as one group. in the layout properties under complication settings, click + and select icon + text. then, change the default provider to watch battery and set the type to fixed. group battery level and battery icon together. rename the group as group_batterylevel. move the group_batterylevel placement to bottom right. heart rate add a circular progress bar and rename the component as heart rate. drag the background slider to 0%. go to value properties. replace the value to 0 and, in tags, input or choose [hr] to use heart rate as value. set max value to 220 since it’s the maximum heart rate a person can have. add a text component and rename it as heart rate label. in the text field, input heart rate and change the text size to 12. change the y placement to 195. add another text component and rename it as heart rate text. in the text field, input [hr] and change the text size to 30. group heart rate, heart rate label, and heart rate text together. rename the group as group_heartrate. in action properties of group_heartrate, select apply action with tap interaction and measure heartrate as action. heart rate will be measured when the components in the group_heartrate is tapped in the device. move the group_heartrate placement to center right. step count add a circular progress bar and rename the component as step count. drag the background slider to 0%. go to value properties. replace the value to 0 and, in tags, input or choose [sc_per] to use the current percentage to goal of step count. add a short text complication and rename it as step count text. in the layout properties, click + and select text + title. select step count as the default provider and set its type to fixed. it will now show "steps" as title and step count as text. place the step count text in the center horizontally. group step count and step count text together. rename the group as group_stepcount. move the group_stepcount placement to top right. select group_digitaltime, group_batterylevel, group_heartrate, and group_stepcount folders and drag them behind group_analoghands and seconds. by doing this, the analog hands would overlap the components. make use of tag expressions you already have three progress bars that show data of battery level, heart rate, and step count. this time, you will make these features more functional by changing the progress bars' color to red and add a blinking effect to a component using tag expressions. tag expressions are conditions that allow you to change the rotation, placement, behavior, and opacity of a component based on tag values. it has the power to alter your watch face appearance dynamically as the tag value changes. tag expressions support different types of operators – arithmetic, relational, logical, and ternary. for this step, you will apply tag expressions on the color opacity. but first, you will have to: make a duplicate of all the circular progress bars (seconds, battery level, heart rate, and step count). move all the duplicates in a new group called group_colorchange. make sure that group_colorchange is behind all other groups. change individual component’s color to #ffffff or white. duplicate this group and rename as group_background. move it behind group_colorchange. drag the background slider to 16% and remove tags in value properties of each component of group_background. change group_colorchange color to #ff001e or red. group_colorchange will be used as components underneath when you set the opacity of the main components to 0 using tag expressions. group_background will serve as gap filler of each progress bar. below are conditions that will trigger the opacity of main components to become 0 and reveal the duplicated red components: change the color of battery level to red if the battery level is equal or less than 20% go to group_batterylevel and select battery level. navigate to color properties. check if the color opacity value is 100. this will serve as the base value. in tags, input [batt_per]<=20?-100:0 to subtract 100 to base value of opacity if the battery level is equal or less than to 20. otherwise, the base opacity value remains the same. in the run pane, adjust the device > watch battery to 20% or less, and you will see how the color will change to red. change the color of step count to red if the goal hasn’t reached yet and the time is already 18:00 (6:00 pm) or beyond go to group_stepcount and select step count. navigate to color properties. check if the color opacity value is 100. this will serve as the base value. in tags, input ([sc]<[sc_goal])*([hour_0_23]>=18)?-100:0 to subtract 100 to base value of opacity if the step count is less than the goal, and if the value of hour in a day is 18 or beyond. otherwise, the base opacity value remains the same. play with the time control bar in the run pane and health > steps data to see how the color will change from blue to red. change the color of heart rate and seconds to red if heart rate is below or above the normal go to group_heartrate and select heart rate. navigate to color properties. check if the color opacity value is 100. this will serve as the base value. in tags, input ([hr]<60)+([hr]>100)?-100:0 to subtract 100 to base value of opacity if heart rate is below or above the normal (60-100). otherwise, it remains the same. do the same for group_analogtime > seconds. test it in the run pane by adjusting the health > heart rate to below 60 or above 100 and you will see how the color will change to red. since you added a tap action to measure heart rate, it is a good user experience to see if this function works. hr_is_measuring is a boolean tag, which returns 1 (yes) or 0 (no) if the heart rate is currently measuring or not. to add this to the project: select group_heartrate > heart rate. go to value properties and, in tags, change [hr] to [hr_is_measuring]==1? ([sec]%2==1?220:0):[hr]. this will cause the progress bar to flash on (max value) and off (min value) every second while heart rate is measuring. once it is done measuring, it will display the heart rate data. do the same for group_colorchange > heart rate copy. prolong the battery life now that you already grasp the idea of what group and tag expression are, it’s about time for you to use both for your advantage. it is observed that the darker a watch face design is, the longer the battery life can be. to help the watch stay powered even when there’s a little battery left, you will need to decrease the opacity of the watch face when the battery level is equal to or less than 10%. to do this, you have to: select and combine all created groups and components, except for group analogtime, to a new group called group_watchface. go to group_watchface color properties and change the base opacity value to 20 in tags, input [batt_per]<=10?0:80 to add 0 to the base value of opacity if the battery level is equal or less than to 10. otherwise, it adds 80 to the base value, making the whole watch face 100% visible. adjust the device > watch battery to 10% or less, and you will see how the opacity of most of the components decreased. choose components for always-on always-on display is a feature that allows your galaxy watch to show the time without checking on it by pressing a button or lifting your hand. in watch face studio, you can choose which group or component to display onto the always-on by following these steps: go to the always-on tab, and you will see the same set of components you added and grouped. click the eye icon next to the group name to hide or make it visible. hide group_watchface. at this point, your always-on display will display a basic analog watch face whenever your watch is in idle mode. test the watch face to test your watch face, you need to: connect a watch device to the same network as your computer in watch face studio, select project > run on device. select the connected watch device you want to test with. if your device is not detected automatically, click scan devices to detect your device or enter its ip address manually by clicking the + button. you're done! congratulations! you have successfully achieved the goal of this code lab. now, you can create and design a watch face using tag expressions by yourself! if you're having trouble, you may download this file: tag expression complete project (234.24 kb) to learn more about watch face studio, visit: developer.samsung.com/watch-face-studio

one ui watch find the latest news on one ui watch and watch face studio design apps for galaxy watch, running on wear os one ui watch on a new unified platform will create an entirely new galaxy watch experience. to start creating an application for galaxy watch, check out the design principles and information on various interaction types. get started design principles watch face studio get acquainted with watch face studio, which lets you turn your ideas into wear os watch faces! learn more galaxy watch studio converter you can easily convert watch faces you’ve created with galaxy watch studio into wear os watch faces. try it now! get started design apps for galaxy watch, running on tizen understanding the basic approaches to design for the watch’s compact circular display. design principles galaxy watch studio for tizen galaxy store asset creator create a professional-looking product detail page for galaxy store using the asset creator, a photoshop template that is quick and easy to use. learn more

galaxy watch learn about your options for developing apps for galaxy watch develop apps for galaxy watch, running on wear os powered by samsung to start creating an application for galaxy watch, click the button below to view the principles of development. get started watch face studio get acquainted with watch face studio, which lets you turn your ideas into wear os watch faces! learn more galaxy watch studio converter you can easily convert watch faces you’ve created with galaxy watch studio into wear os watch faces. try it now! get started play store asset creator create a professional-looking product detail page for play store using the asset creator, a photoshop template that is quick and easy to use. learn more develop apps for galaxy watch, running on tizen all the documents and data you need to develop galaxy watch apps for tizen get started community forums ask questions and find answers in our forums. watch face studio galaxy watch for tizen

watch face studio is an intuitive graphical tool that provides designers a means to design watch faces without jumping into complex coding. complication design is a major feature of this tool, and layout is a vital property of complications. the layout enables you to place components as you wish to create eye-catching watch faces. to learn more about complications, see the design complications using watch face studio blog post. watch face studio has six complication types: short text monochromatic image ranged value long text small image large image each complication has a set of layout options. you can use the layout to present information in a coherent way and make important elements stand out. this article introduces three important behaviors that you must keep in mind when working with complication layouts. blank elements in the default layout some complication providers do not provide data for all the components on a complication. elements without data remain blank on the watch face. for example, figure 1a shows the default layout for the short text complication. it displays the icon, title, and text from the provider. the "step count" provider does not include an icon. if the default layout is used with the "step count" provider, the watch face is blank where the icon is normally displayed, as shown in figure 1b. (a) "icon + text + title" layout (b) no icon for step count figure 1: blank icon slot for step count specifying a single layout watch face studio provides four possible layouts for the short text complication. to implement one specific layout only, you must remove the unwanted layouts from the layout list. for example, if you want to use only the "icon + text" layout, select it and remove the others. (a) keep desired layout and remove others (b) "icon + text" layout on watch figure 2: setting a specific layout components moving between layouts as previously discussed, complication components appear blank when there is no data provided for them. to avoid displaying blank components, you can implement multiple layouts. in this case, the watch automatically selects the appropriate layout based on the complication provider. components changing position this section demonstrates an issue commonly faced when implementing multiple layouts. when the watch switches between layouts, the position of complication components can change undesirably. in figure 3, a short text complication has been selected. to visualize the original position of each component, rectangles have been drawn around them, matching the component boundaries. when the default provider is set to "sunrise sunset" and the default "icon + text + title" layout is selected, the run preview shows the icon and text displaying perfectly within the bounded area. figure 3: visualizing the positions of the default layout components figure 4 shows what happens when the layout is switched to "text + title." the components’ positions have changed and are no longer aligned with our rectangles. note : watch face studio allows you to select and preview any layout. on an actual watch, the user cannot modify or switch layouts. figure 4: complication components changing position between different layouts in figure 5, the watch face has been deployed. customizing the complication reveals that the components do not consistently display in the same location. for example, with the "bixby" or "barometer" providers, the components are in the appropriate positions. however, the components of "feels like temp." and "step count" are not in alignment. (a) bixby (b) feels like temp. (c) step count (d) barometer figure 5: complication components changing position between different layouts on an actual watch fixing the position of complication components this section demonstrates how to make the position of complication components consistent, where the end result is the fixed layout. this resolves the problem of components changing position between layouts. you can follow along with the demonstration by downloading the sample project. to fix the position of complication components: in watch face studio, add a short text complication. to create a rectangle, select add component > shape > rectangle. note : instead of a rectangle, you can also use an ellipse. adjust the position and size of the rectangle to fit the entire layout. set the opacity of the rectangle to 0%. the rectangle becomes invisible. note : in the sample project, for demonstration purposes, the rectangle’s opacity has been set to 20%. give the shape a descriptive name, such as “icon, text, title background.” add the rectangle to the short text complication layout, placing it beneath the icon component. figure 6: adding the rectangle to the layout add the remaining layouts ("text + title," "icon + text," and "text") to the complication. repeat steps 2 to 6 for each layout you want to implement. the following figure shows the result in watch face studio. figure 7: watch face studio view after adding background rectangle when the project is deployed to the watch, the complication components stay in the same place even when switching between layouts. (a) bixby (b) feels like temp. (c) step count (d) barometer figure 8: consistent component position between different layouts conclusion watch face studio provides various layout options for the watch face. the layout considerations described in this blog can help you create an effective layout that enhances and communicates your design to the user. resources for more information about complications, see build complications in watch face studio. you can also visit the samsung developers forum, an active and friendly community where you can ask for and receive help with your application development. the samsung developers site has many resources for developers looking to build for and integrate with samsung devices and services. stay in touch with the latest news by creating a free account and subscribing to our monthly newsletter. visit the marketing resources page for information on promoting and distributing your android apps.

test your watch face watch face studio (wfs) lets you test your watch face both within the tool and on a device. testing in watch face studio in wfs, preview your watch face in the run panel on the right side of the screen. capture your work from the preview window, you can take a screenshot of your watch face preview and save it as an image to your computer. you can use this as the preview image of your watch face when you upload it to the play store, for example. figure 1. watch face preview preview your always-on watch face when you preview the always-on version of your design, you can check the on-pixel ratio. keeping this ratio lower than 15% saves battery life. figure 2. watch face preview and always-on design analyzer, showing the on-pixel ratio preview on watch switch to the watch preview to show your watch face with a device and strap. click through the watch options to preview your watch face on various simulated devices. figure 3. previewing watch face on different watch bodies testing on a physical device it is often useful to test your watch face on a physical watch. to connect your watch and computer for debugging: enable debugging on the watch. ensure that the watch is connected to the same wi-fi network as your computer. in wfs, select project > run on device. select + (enter ip address) and enter your watch’s ip address. select ok. wfs scans for and attempts to connect to the device. figure 4. enter ip address

watch face design review thank you for your interest in becoming a galaxy watch face designer! for galaxy watch4 and later, you are no longer required to have a watch face design partnership with samsung in order to distribute watch face designs. starting with galaxy watch4, samsung switched the watch os from tizen to wear os powered by samsung and new watch apps developed for galaxy watch4 and later are distributed through google play store. if you are a first-time watch face designer or developer: welcome! you are not required to have a watch face design partnership with samsung in order to distribute your designs in play store. discover the options for developing apps for galaxy watch, including watch face studio and the play store asset creator. you can learn more about the principles of wear os development and distributing to wear os from the android developer web site. if you are a previous watch face designer or developer: on february 8, 2023, you will no longer be able to register new tizen-based watch apps in seller portal. instead, we ask that you create your new watch apps for wear os powered by samsung and distribute them from the play store for the latest galaxy watches. note that you can continue to update your existing tizen-based watch apps in seller portal. if you use galaxy watch studio for tizen, we provide some tools to help you transition to wear os powered by samsung, including watch face studio and the galaxy watch studio converter.