iOS screen-capture blocking

[shai-almog]

Motivation

• Clarify the native iOS implementation for the screen-capture blocking feature so readers understand why an overlay is used and why SDK/version guards are necessary.

Description

• Add concise comments to Ports/iOSPort/nativeSources/IOSNative.m describing the black-overlay approach (used because static screenshots cannot be prevented), the choice of container view (prefer GL view controller then key window), the compile-time guard #if __IPHONE_OS_VERSION_MAX_ALLOWED >= 110000 (to avoid building against older SDKs), the runtime guard using respondsToSelector:@selector(isCaptured) and @available(iOS 11.0, *), and the notification observer on UIScreenCapturedDidChangeNotification that updates the overlay when capture starts/stops.

Testing

• No automated tests were run for this documentation-only change.

---

Codex Task

[github-actions]

Developer Guide build artifacts are available for download from this workflow run:

• Developer Guide HTML package
• Developer Guide PDF
• AsciiDoc linter report
• Vale report
• Unused image report

Developer Guide quality checks:

• AsciiDoc linter: No issues found (report)
• Vale: 18765 alert(s) (2766 errors, 6366 warnings, 9633 suggestions) (exit code 1) (report)
• Image references: No unused images detected (report)

[github-actions]

✅ Continuous Quality Report

Test & Coverage

• ✅ Tests: 2283 total, 0 failed, 0 skipped
• 📊 Line coverage: 52.79% [HTML preview] [Download]
  • Lowest covered classes
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertyListActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsPropertiesActionListener – 0.00%
    • com.codename1.ui.Display$EdtException – 0.00%
    • com.codename1.ui.BrowserWindow$BrowserForm – 0.00%
    • com.codename1.ui.plaf.CSSBorder$LinearGradient – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsStringAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsJsonMapActionListener – 0.00%
    • com.codename1.payment.Purchase$SynchronizeReceiptsSyncRunnable – 0.00%
    • com.codename1.io.rest.RequestBuilder$GetAsBytesAsyncImplActionListener – 0.00%
    • com.codename1.io.rest.RequestBuilder$FetchAsJsonMapActionListener – 0.00%

Static Analysis

• ✅ SpotBugs: 0 findings (no issues) [Report archive]
• ✅ PMD: 0 findings (no issues) [Report archive]
• ✅ Checkstyle: 0 findings (no issues) [Report archive]

Generated automatically by the PR CI workflow.

[shai-almog]

Compared 30 screenshots: 30 matched.

Native Android coverage

• 📊 Line coverage: 7.15% (3629/50728 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 5.58% (17811/319458), branch 2.71% (843/31079), complexity 3.31% (984/29700), method 5.84% (807/13829), class 9.52% (174/1827)
  • Lowest covered classes
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6327 lines covered)
    • kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader – 0.00% (0/1519 lines covered)
    • kotlin.collections.kotlin.collections.CollectionsKt___CollectionsKt – 0.00% (0/1148 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.MethodWriter – 0.00% (0/923 lines covered)
    • kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/712 lines covered)
    • kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/623 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.Frame – 0.00% (0/564 lines covered)
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysJvmKt – 0.00% (0/495 lines covered)
    • kotlinx.coroutines.kotlinx.coroutines.JobSupport – 0.00% (0/423 lines covered)

✅ Native Android screenshot tests passed.

Native Android coverage

• 📊 Line coverage: 7.15% (3629/50728 lines covered) [HTML preview] (artifact android-coverage-report, jacocoAndroidReport/html/index.html)
  • Other counters: instruction 5.58% (17811/319458), branch 2.71% (843/31079), complexity 3.31% (984/29700), method 5.84% (807/13829), class 9.52% (174/1827)
  • Lowest covered classes
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysKt – 0.00% (0/6327 lines covered)
    • kotlin.collections.unsigned.kotlin.collections.unsigned.UArraysKt___UArraysKt – 0.00% (0/2384 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader – 0.00% (0/1519 lines covered)
    • kotlin.collections.kotlin.collections.CollectionsKt___CollectionsKt – 0.00% (0/1148 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.MethodWriter – 0.00% (0/923 lines covered)
    • kotlin.sequences.kotlin.sequences.SequencesKt___SequencesKt – 0.00% (0/712 lines covered)
    • kotlin.text.kotlin.text.StringsKt___StringsKt – 0.00% (0/623 lines covered)
    • org.jacoco.agent.rt.internal_b6258fc.asm.org.jacoco.agent.rt.internal_b6258fc.asm.Frame – 0.00% (0/564 lines covered)
    • kotlin.collections.kotlin.collections.ArraysKt___ArraysJvmKt – 0.00% (0/495 lines covered)
    • kotlinx.coroutines.kotlinx.coroutines.JobSupport – 0.00% (0/423 lines covered)

[shai-almog]

Compared 30 screenshots: 30 matched.
✅ Native Android screenshot tests passed.

Benchmark Results

• VM Translation Time: 392 seconds
• Compilation Time: 378 seconds

Detailed Performance Metrics

Metric	Duration
Build Time Statistics
Setup & Unzip	34579 ms
Extract Extensions	37 ms
Google Services Setup	5 ms
Scan Classes	839 ms
Extract Libs	1530 ms
Inject Build Hints	41 ms
Generate Unit Tests	7 ms
Generate Stubs	1174 ms
Compile Stubs	2322 ms
Generate Icons	977 ms
Prepare ParparVM	214 ms
ParparVM Execution	210235 ms
Post-VM Setup	177 ms
CocoaPods	6754 ms
Finalize	24 ms
Total Time	258916 msMaven Overhead : 134000 ms
CocoaPods Install (Script)	2000 ms
Simulator Boot	168000 ms
Simulator Boot (Run)	8000 ms
App Install	24000 ms
App Launch	11000 ms
Test Execution	195000 ms