Skip to content

Document device name behavior for LCP registration#752

Merged
mickael-menu merged 1 commit intodevelopfrom
fix/doc-lcp
Mar 23, 2026
Merged

Document device name behavior for LCP registration#752
mickael-menu merged 1 commit intodevelopfrom
fix/doc-lcp

Conversation

@mickael-menu
Copy link
Copy Markdown
Member

Since iOS 16, UIDevice.current.name returns a generic string (e.g. "iPhone") instead of the user-assigned device name. This affects LCP device registration with LSD servers, where the device name is used to identify the device.

This PR adds a new section to the LCP guide explaining:

  • The iOS 16 behavioral change
  • How to request the com.apple.developer.device-information.user-assigned-device-name entitlement to restore the user-assigned name
  • How to pass a custom deviceName via LCPService.init as an alternative

Copilot AI review requested due to automatic review settings March 23, 2026 09:33
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the iOS 16+ change to UIDevice.current.name (generic device name) and how it impacts Readium LCP device registration, including recommended mitigations.

Changes:

  • Add an LCP guide section describing iOS 16 device name behavior and mitigation options.
  • Expand LCPService initializer docs to warn about iOS 16+ generic device names and the relevant entitlement.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/Guides/Readium LCP.md Adds documentation for iOS 16 device-name behavior and options (entitlement or custom deviceName) for LCP registration.
Sources/LCP/LCPService.swift Updates parameter documentation to clarify iOS 16+ behavior and entitlement requirement for user-assigned device names.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/Guides/Readium LCP.md
Comment thread docs/Guides/Readium LCP.md
@mickael-menu mickael-menu merged commit 65937ea into develop Mar 23, 2026
8 of 9 checks passed
@mickael-menu mickael-menu deleted the fix/doc-lcp branch March 23, 2026 09:45
darktasevski added a commit to darktasevski/swift-toolkit that referenced this pull request Apr 9, 2026
* upstream/develop:
  Fix decoration positions with paragraph indent (readium#767)
  Replace SwiftSoup with regex-based attribute lookup in Readium CSS injection (readium#742)
  Add support for SVG covers (readium#751)
  Fix race condition when applying EPUB decorations (readium#765)
  Add slide animation for adjacent EPUB resource transitions (readium#763)
  Remove unavailable APIs (readium#759)
  Remove Carthage support (readium#760)
  Improve `DirectionalNavigationAdapter` (readium#757)
  Update JSON usage from `Any` to `JSONValue` (readium#740)
  Fix LCP-enabled TestApp (readium#754)
  Report continuous `totalProgression` in the EPUB locator (readium#753)
  Document device name behavior for LCP registration (readium#752)
  Fix screen flashes during unanimated page turns in the EPUB navigator (readium#750)
  Fix parsing of URI templates (readium#749)
  Fix EPUB contributor role parsing (readium#748)
  Introduce the Readium Swift Playground (readium#746)

# Conflicts:
#	Sources/Navigator/EPUB/Assets/Static/scripts/readium-fixed.js
#	Sources/Navigator/EPUB/Assets/Static/scripts/readium-reflowable.js
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants