Guides

Global Config

GlobalConfig controls application-level global behavior, including theme mode, file save strategy, BOTA panel, search highlighting, thumbnails, page editor, and more.

Configuration Fields Overview

Field	Type	Default	Description
themeMode	String	"system"	Application theme mode
fileSaveExtraFontSubset	boolean	true	Whether to embed font subsets when saving
useSaveIncremental	boolean	true	Whether to use incremental save
signatureType	String	"manual"	Default signature type
enableExitSaveTips	boolean	true	Whether to show save prompt when exiting
enableErrorTips	boolean	true	Whether to show error tips

Theme Mode

themeMode controls the overall application theme:

Value	Description
light	Light mode
dark	Dark mode
system	Follow system (default)

{
  "global": {
    "themeMode": "system"
  }
}

themeMode controls the application UI framework theme (status bar, toolbar background, etc.), which is different from readerViewConfig.themes that controls the PDF page reading theme. See Theming & Styles for the differences.

Save Behavior

{
  "global": {
    "fileSaveExtraFontSubset": true,
    "useSaveIncremental": true,
    "enableExitSaveTips": true
  }
}

Field	Description
fileSaveExtraFontSubset	Embed font subsets when saving to ensure edited text displays correctly on other devices
useSaveIncremental	Incremental save only appends changed data to the end of the file; faster but file may gradually grow
enableExitSaveTips	Show a save prompt dialog when exiting the document if there are unsaved changes

Signature Type

{
  "global": {
    "signatureType": "manual"
  }
}

Value	Description
manual	Handwritten signature (default)
digital	Digital signature
electronic	Electronic signature

Watermark Configuration

global.watermark configures the default values for the watermark dialog:

{
  "global": {
    "watermark": {
      "types": ["text", "image"],
      "saveAsNewFile": false,
      "text": "",
      "image": "tools_logo",
      "textSize": 80,
      "textColor": "#FF000000",
      "scale": 1.0,
      "rotation": -45,
      "opacity": 255,
      "isFront": false,
      "isTilePage": false
    }
  }
}

Field	Description
types	Available watermark types: text, image
saveAsNewFile	Whether to save as a new file
text	Default text content
image	Default image resource name (from drawable)
textSize	Text font size
textColor	Text color
scale	Scale ratio
rotation	Rotation angle
opacity	Opacity (0-255)
isFront	Whether on page foreground (true) or background (false)
isTilePage	Whether to tile across the entire page

Thumbnail Configuration

{
  "global": {
    "thumbnail": {
      "title": "",
      "backgroundColor": "",
      "editMode": true
    }
  }
}

Field	Description
title	Thumbnail panel title
backgroundColor	Background color
editMode	Whether to enable thumbnail edit mode (supports page drag-to-reorder, delete, etc.)

BOTA Panel Configuration

The BOTA (Book Of Annotations) panel contains three tabs: outline, bookmarks, and annotation list.

{
  "global": {
    "bota": {
      "tabs": ["outline", "bookmark", "annotations"],
      "menus": {
        "annotations": {
          "global": [
            { "id": "importAnnotation" },
            { "id": "exportAnnotation" },
            { "id": "removeAllAnnotation" },
            { "id": "removeAllReply" }
          ],
          "item": [
            {
              "id": "reviewStatus",
              "subMenus": ["accepted", "rejected", "cancelled", "completed", "none"]
            },
            { "id": "markedStatus" },
            {
              "id": "more",
              "subMenus": ["addReply", "viewReply", "delete"]
            }
          ]
        }
      }
    }
  }
}

BOTA Tabs

Value	Description
outline	Document outline (table of contents)
bookmark	Bookmarks
annotations	Annotation list

Annotation List Menus

Global menus (global): Operations that apply to the entire annotation list.

id	Description
importAnnotation	Import annotations
exportAnnotation	Export annotations
removeAllAnnotation	Remove all annotations
removeAllReply	Remove all replies

Item menus (item): Operations for individual annotation entries.

id	Description
reviewStatus	Review status (sub-menus: accepted/rejected/cancelled/completed/none)
markedStatus	Marked status
more	More actions (sub-menus: addReply/viewReply/delete)

Search Highlight Configuration

{
  "global": {
    "search": {
      "normalKeyword": {
        "borderColor": "#00000000",
        "fillColor": "#77FFFF00"
      },
      "focusKeyword": {
        "borderColor": "#00000000",
        "fillColor": "#CCFD7338"
      }
    }
  }
}

Field	Description
normalKeyword	Highlight style for normal search results (border color + fill color)
focusKeyword	Highlight style for the currently focused search result

Page Editor Configuration

{
  "global": {
    "pageEditor": {
      "menus": [
        "insertPage",
        "replacePage",
        "extractPage",
        "copyPage",
        "rotatePage",
        "deletePage"
      ]
    }
  }
}

Menu Item	Description
insertPage	Insert page
replacePage	Replace page
extractPage	Extract page
copyPage	Copy page
rotatePage	Rotate page
deletePage	Delete page