Skip to main content

Appearance (7.x Beta)

7.x Beta

This page documents the 7.x beta. In 7.x, the monolithic BugseeAppearance data class from 6.x has been replaced by a typed Appearance contract with namespaced string property keys. Those keys are declared as constants on three sibling contract interfaces:

  • ReportAppearance (core, bugsee-android) — bug-report UI colors and placeholders.
  • NotificationAppearance (core, bugsee-android) — notification trigger title.
  • FeedbackAppearance (feedback extension, bugsee-android-feedback) — feedback / chat UI colors.

See the 6.x → 7.x migration guide for the field-rename mapping.

Accessing appearance

The entry point is Bugsee.getAppearance(), which returns a com.bugsee.library.contracts.appearance.Appearance instance. Unlike the 6.x data class, the 7.x Appearance exposes only typed getters and setters:

Appearance setColor(String propertyName, Integer color);
Integer getColor(String propertyName);
Appearance setString(String propertyName, String value);
String getString(String propertyName);

Setters return the Appearance instance for chaining. Property keys are the namespaced String constants exposed on ReportAppearance, NotificationAppearance, and FeedbackAppearance.

import com.bugsee.library.Bugsee;
import com.bugsee.library.contracts.appearance.Appearance;
import com.bugsee.library.contracts.appearance.ReportAppearance;
import com.bugsee.library.contracts.appearance.FeedbackAppearance;

Appearance appearance = Bugsee.getAppearance();
appearance
.setColor(ReportAppearance.ActionBarColor, Color.BLACK)
.setColor(FeedbackAppearance.OutgoingBubbleColor, Color.BLUE);

Always reference the constants on the contract interfaces — don't type the raw namespaced strings (e.g. "Report::ActionBarColor") directly.

ReportAppearance

Package: com.bugsee.library.contracts.appearance.ReportAppearance. Shipped with the core bugsee-android library. Controls the built-in bug-reporting UI.

ConstantSetterPurpose
ReportAppearance.ActionBarColorsetColorAction bar background color in the Report UI.
ReportAppearance.EditTextBackgroundColorsetColorEditText background color in the Report UI.
ReportAppearance.VersionColorsetColorBugsee version label text color.
ReportAppearance.TextColorsetColorTextView and EditText text color.
ReportAppearance.HintColorsetColorEditText hint text color.
ReportAppearance.ActionBarTextColorsetColorAction bar button text color.
ReportAppearance.ActionBarButtonBackgroundClickedColorsetColorAction bar button background in the clicked state.
ReportAppearance.BackgroundColorsetColorReport UI background color.
ReportAppearance.SeverityLabelActiveColorsetColorSeverity label text color in the active state.
ReportAppearance.SummaryPlaceholdersetStringPlaceholder displayed in the Summary field.
ReportAppearance.DescriptionPlaceholdersetStringPlaceholder displayed in the Description field.
ReportAppearance.LabelsPlaceholdersetStringPlaceholder displayed in the Labels field.
ReportAppearance.EmailPlaceholdersetStringPlaceholder displayed in the Email field.
Bugsee.getAppearance()
.setColor(ReportAppearance.ActionBarColor, Color.parseColor("#263238"))
.setColor(ReportAppearance.BackgroundColor, Color.WHITE)
.setString(ReportAppearance.SummaryPlaceholder, "What went wrong?");

NotificationAppearance

Package: com.bugsee.library.contracts.appearance.NotificationAppearance. Shipped with the core bugsee-android library. Controls the notification-based report trigger.

ConstantSetterPurpose
NotificationAppearance.TitlesetStringTitle shown in the Bugsee system notification.
note

The 6.x NotificationTitleResId field has no 7.x equivalent. Resolve the string resource yourself and pass the resolved value via NotificationAppearance.Title.

Bugsee.getAppearance()
.setString(NotificationAppearance.Title, getString(R.string.bugsee_notification_title));

FeedbackAppearance

Package: com.bugsee.library.contracts.appearance.FeedbackAppearance. Shipped with the feedback extension module (bugsee-android-feedback) and only available when that module is on the classpath. Controls colors in the feedback / chat UI.

ConstantSetterPurpose
FeedbackAppearance.ActionBarColorsetColorAction bar background color.
FeedbackAppearance.BackgroundColorsetColorFeedback UI background color.
FeedbackAppearance.ActionBarButtonBackgroundClickedColorsetColorAction bar button background in the clicked state.
FeedbackAppearance.IncomingBubbleColorsetColorIncoming message bubble background.
FeedbackAppearance.OutgoingBubbleColorsetColorOutgoing message bubble background.
FeedbackAppearance.IncomingTextColorsetColorIncoming message text color.
FeedbackAppearance.OutgoingTextColorsetColorOutgoing message text color.
FeedbackAppearance.DateTextColorsetColorMessage date text color.
FeedbackAppearance.TitleTextColorsetColorAction bar title text color.
FeedbackAppearance.EmailSkipTextColorsetColor"Skip" button text color in the ask-for-email dialog.
FeedbackAppearance.EmailSkipBackgroundClickedColorsetColor"Skip" button background in the clicked state.
FeedbackAppearance.EmailBackgroundColorsetColorAsk-for-email dialog background.
FeedbackAppearance.EmailContinueNotActiveColorsetColor"Continue" button background in the disabled state.
FeedbackAppearance.EmailContinueActiveColorsetColor"Continue" button background in the enabled state.
FeedbackAppearance.EmailContinueClickedColorsetColor"Continue" button background in the clicked state.
FeedbackAppearance.InputTextColorsetColorInput message text color.
FeedbackAppearance.InputTextHintColorsetColorInput message hint text color.
FeedbackAppearance.BottomDelimiterColorsetColorDelimiter between the message list and the input field.
FeedbackAppearance.LoadingBarBackgroundColorsetColorBackground of the loading / status bar.
FeedbackAppearance.LoadingTextColorsetColorText color in the loading bar.
FeedbackAppearance.ErrorTextColorsetColorError description text color.
FeedbackAppearance.VersionChangedBackgroundColorsetColorBackground of the "version changed" bar.
FeedbackAppearance.VersionChangedTextColorsetColorText color of the "version changed" bar.
Bugsee.getAppearance()
.setColor(FeedbackAppearance.IncomingBubbleColor, Color.parseColor("#ECEFF1"))
.setColor(FeedbackAppearance.OutgoingBubbleColor, Color.parseColor("#1E88E5"))
.setColor(FeedbackAppearance.OutgoingTextColor, Color.WHITE);

Timing

Bugsee.getAppearance() is safe to call before or after the SDK is launched — the returned Appearance instance is process-wide and persists across Bugsee.launch() / Bugsee.stop() / Bugsee.relaunch() cycles. Apply your appearance overrides as early as convenient (for example, in your Application.onCreate() alongside launch configuration) so they are in effect before any report dialog, notification, or feedback activity is shown.