The latest articles on DEV Community by 朱威坚 (@_2fa19d454855a7f7f6ff3). https://dev.to/_2fa19d454855a7f7f6ff3 https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4214088%2Fb10e3916-04b1-40e3-a5df-334936cf3ddf.png https://dev.to/_2fa19d454855a7f7f6ff3 en 朱威坚 Thu, 29 Oct 2026 02:17:52 +0000 https://dev.to/_2fa19d454855a7f7f6ff3/shipping-a-16-language-android-app-how-we-stopped-translation-drift-1ljn https://dev.to/_2fa19d454855a7f7f6ff3/shipping-a-16-language-android-app-how-we-stopped-translation-drift-1ljn <p>We ship a Bazi (Four Pillars) and feng shui app on Google Play. Sixteen languages, one codebase.</p> <p>The problem we hit was not translation itself. It was drift.</p> <h2> What went wrong </h2> <p>Every screen rendered terms like Heavenly Stem and Earthly Branch from localized strings. Some code paths used a translated label as a map key. That works in Chinese. It explodes in Korean.</p> <p>We also had placeholder collisions: <code>$mingGong</code> is a prefix of <code>$mingGongAnalysis</code>, so the template engine truncated the longer name and users saw <code>병사Analysis</code>.</p> <h2> What we changed </h2> <ol> <li> <strong>Server returns language-neutral codes, not text.</strong> <code>gan:"bing"</code>, <code>shiShen:"piancai"</code>, <code>naYin:"luzhonghuo"</code>. The value is stable across all 16 locales.</li> <li> <strong>One client-side term database renders codes to text.</strong> 75 term codes x 16 languages in a single lookup. Adding a column means adding entries, not touching screens.</li> <li> <strong>Server only adds fields, never changes old ones.</strong> Older app versions ignore unknown keys, so a field addition cannot break users on a previous release.</li> <li> <strong>Braced placeholders only.</strong> <code>${name}</code>, never <code>$name</code>.</li> </ol> <h2> Result </h2> <p>We audited the source: 1,267 localization call sites. Our coverage went from about 55% to 78%, and the remaining gaps are now enumerable instead of discovered by users.</p> <p>Current release fixes eight languages completely: English, Japanese, Korean, Traditional Chinese, Thai, Vietnamese, Indonesian, Malay. The other seven are in progress.</p> <p>If you maintain a multi-locale app: make your server emit codes, and keep exactly one rendering path on the client.</p> <p>mysticfate.net</p> android mobile softwaredevelopment