docs: consolidate on-device debugging chapters, add checkers & card game case studies#5220
Merged
shai-almog merged 2 commits intoJun 11, 2026
Conversation
Fixes #5215 by consolidating the stale "On device debugging" section (21.3) in Advanced Topics into the dedicated per-platform chapters: - Advanced Topics now points at the two dedicated chapters; the obsolete Gradle 2.11 / manual sources.zip walkthroughs are removed along with the orphaned gradle-settings.png. - On-Device Debugging (iOS) gains "Debugging the generated Xcode project natively": cn1:buildIosXcodeProject / cloud Include Source, the .xcworkspace note, LLDB/Instruments and ParparVM C symbol names. - On-Device Debugging (Android) gains "Debugging the generated Gradle project from Android Studio": cn1:buildAndroidGradleProject / cloud Include Source, plus an NDK/LLDB cross-reference. - Fix the build-hint table links that pointed at non-existent #_ondevice_debugging_* anchors. Also fills the two gaps in the Game Development chapter: dedicated case-study sections with screenshots and code for CardGameSample (sprite-per-card, scale-through-zero flip, polled tap hit-testing, countdown timers) and BoardGameSample (isometric projection and inverse picking, z-order depth, shadow + raised-piece height illusion, rebuild-don't-mutate scene sync). Screenshots captured from the simulator with the iPhoneX skin showing real mid-game state. While validating the full-guide asciidoctor build, fixed the four pre-existing unresolved cross-references (working-with-codename-one- sources, TitleAndLabelImage, binding-framework x2); the guide now builds with zero unresolved refs. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
|
Developer Guide build artifacts are available for download from this workflow run:
Developer Guide quality checks: |
Contributor
Cloudflare Preview
|
Capitalize the case-study headings after the colon (and their xrefs), spell out the four-by-four grid, avoid a paragraph-initial "But" and drop an adverb flagged by Microsoft.Adverbs. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
shai-almog
deleted the
docs-consolidate-ondevice-debugging-game-case-studies
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #5215
On-device debugging consolidation (#5215)
The "On device debugging" section (21.3) in Advanced Topics/Under the Hood duplicated — in a very outdated form (Gradle 2.11 instructions, manual
sources.zipmerging) — what the dedicated On-Device Debugging chapters now cover. This PR consolidates it:gradle-settings.pngare removed. The build-hint table links that pointed at non-existent#_ondevice_debugging_*anchors are fixed.cn1:buildIosXcodeProject/ cloud Include Source flag, the.xcworkspaceguidance preserved from the old section, LLDB/Instruments, and how Java methods map to ParparVM-generated C symbols.cn1:buildAndroidGradleProject/ cloud Include Source, modern Android Studio opens the generated project directly, plus an NDK/LLDB cross-reference. (The olduserSources.jaradvice was dropped; it no longer exists in the Maven build.)Game Development chapter: checkers & card demos
CardGameSampleandBoardGameSamplewere only name-dropped in bullets — no screenshots, no code. Added two case-study sections (placed as a bridge into "3D and perspective"):GameInput, countdown-timer game-loop pattern.(r+c)z-order depth, the shadow + raised-piece height illusion, and the rebuild-don't-mutatesyncPieces()scene sync.Both screenshots were captured from the simulator with the iPhoneX skin (matching the existing
game-*.pngstyle, 880px wide) and show genuine mid-game state — two matched pairs + one card mid-turn, and a checkers position after an exchange with a selected piece and highlighted destination.Cross-reference cleanup
Validating the full-guide asciidoctor build surfaced four pre-existing unresolved cross-references, now fixed: missing
[[working-with-codename-one-sources]]and[[TitleAndLabelImage]]anchors, and two<<binding-framework>>refs inio.asciidocretargeted to the JSON/XML Object Mapping chapter.The complete developer guide now builds with zero unresolved references.
🤖 Generated with Claude Code