<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Ferlix Yanto Wang on Medium]]></title>
        <description><![CDATA[Stories by Ferlix Yanto Wang on Medium]]></description>
        <link>https://medium.com/@ferlixyantowang?source=rss-eb677b2fca35------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*puku7Q8VZvlOMQ3l0tVgFg.png</url>
            <title>Stories by Ferlix Yanto Wang on Medium</title>
            <link>https://medium.com/@ferlixyantowang?source=rss-eb677b2fca35------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 12:46:36 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ferlixyantowang/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Facilitate Your iOS Crash Log Translation For Numerous Builds]]></title>
            <link>https://medium.com/tokopedia-engineering/facilitate-your-ios-crash-log-translation-for-numerous-builds-8cbd614fe88b?source=rss-eb677b2fca35------2</link>
            <guid isPermaLink="false">https://medium.com/p/8cbd614fe88b</guid>
            <category><![CDATA[symbolicate]]></category>
            <category><![CDATA[translation]]></category>
            <category><![CDATA[crash]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[development]]></category>
            <dc:creator><![CDATA[Ferlix Yanto Wang]]></dc:creator>
            <pubDate>Mon, 07 Feb 2022 08:30:47 GMT</pubDate>
            <atom:updated>2022-02-07T08:30:47.548Z</atom:updated>
            <content:encoded><![CDATA[<h4>Symbolication</h4><blockquote>A process of translating crash stack traces into readable function names and line numbers in source code to understand why an app crashes. (Apple Documentation)</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p-c9Uc-ShVfFqQSNtCtSdg.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*9RoKIwgK36lXnK85CSri7Q.png" /></figure><p>Let’s face it, most of us might have wished the same thing, hoping the app that we create will work smoothly without any issue. But, the hard truth is when developing an app, in this case, iOS applications, we will find crashes, either in the app that has been released to the App Store or in the one that is still in development. And when someone finds it, we will try to reproduce the issue in the Xcode until we find out that silly block of code that causes it. In the worst case, we cannot replicate the crash, resulting in the panic starting to seep in.</p><p>Now, you might be wondering, “<em>Why don’t we use third-party tools? </em><a href="https://firebase.google.com/products/crashlytics?gclid=Cj0KCQiAoNWOBhCwARIsAAiHnEghr97uCe85ZU1XPD8FYSGPe4czrg3B4cy2xUFURirMWFsT8qVeqlgaAvY3EALw_wcB&amp;gclsrc=aw.ds"><em>Crashlytics</em></a><em> is built just for this</em>”. Well, that’s true and not true. We implement Crashlytics for the Tokopedia iOS app released to the App Store. But, we don’t use that for the development environment since we generate lots of builds in a day, and most Crashlytics’ features are unnecessary for the development environment. Therefore, in iOS Tokopedia, we decided to improve our crash debugging process by creating a crash translation service that focuses on the development environment.</p><h3>Let’s Get Started</h3><p>When a crash occurs in an iOS app, the operating system will generate a file that contains an encoded crash log. This log is called a <strong><em>.ips</em></strong> file. We can retrieve it from the device where the app is crashed by following these <a href="https://developer.apple.com/documentation/xcode/acquiring-crash-reports-and-diagnostic-logs#Locate-Crash-Reports-and-Memory-Logs-on-the-Device">steps</a>. This is an example of what the .ips file looks like.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5e40110c4b1dd41ba4b32b2c774ae750/href">https://medium.com/media/5e40110c4b1dd41ba4b32b2c774ae750/href</a></iframe><figure><img alt="" src="https://cdn-images-1.medium.com/max/351/1*zx67p57Cm5nUskQ5WRX-vQ.png" /></figure><p>Yay! Now, we are one step closer to dealing with this crash. But wait, we can’t read these hexadecimal blocks 🤔. We need to translate this file first before we can read it. Translating a <em>.ips</em> file is like opening a treasure chest with two different keys, and we need a particular person to open it. You can refer to this illustration below to have a better visualization.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vYc8POIZ7gfbFhWFYa2MVw.png" /><figcaption>Illustration of the .ips translation process. Icons designed by <a href="http://www.freepik.com/">Freepik</a></figcaption></figure><h4>1. <a href="https://developer.apple.com/documentation/xcode/adding-identifiable-symbol-names-to-a-crash-report#Acquire-Device-Symbol-Information">Device Symbol</a></h4><p>A device symbol is a set of information used to translate the operating system’s frameworks, such as the <em>UIKitCore </em>and <em>libswiftCore.dylib</em> shown in the previous encoded crash log.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/475d4108673180b6c4b57c16827c842a/href">https://medium.com/media/475d4108673180b6c4b57c16827c842a/href</a></iframe><p>We can collect a device symbol by connecting the device to the Mac. The symbols are specific for each operating system and the CPU architecture of the device. Therefore, if the crash occurs on an iPhone running iOS 15.0, we will need to use a device symbol for iOS 15.0 to translate the encoded log. By the way, let me share a secret here 🤫. To save some space, we just need to keep the device symbol of the latest patch version of that iOS version. For example, iOS 15.0 is released multiple times as iOS 15.0.0, 15.0.1, and 15.0.2. In this case, we just need to store the device symbol from iOS 15.0.2 and we can use it to translate all of the crashes that occur on an iPhone that runs on iOS 15.0.</p><h4>2. <a href="https://developer.apple.com/documentation/xcode/adding-identifiable-symbol-names-to-a-crash-report#Locate-a-dSYM-Using-Spotlight">dSYM (Debug Symbol File)</a></h4><p>A<em> dSYM</em> file contains a set of symbols needed to translate your application’s framework, such as the <em>TokopediaDebug </em>library shown in the encoded crash log.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1ef350e257198178ec7ab4f0604dbacf/href">https://medium.com/media/1ef350e257198178ec7ab4f0604dbacf/href</a></iframe><p>These symbols are generated and are <a href="https://help.apple.com/xcode/mac/current/#/devef5928039">downloadable</a> when you upload your app to the App Store Connect or from your application distribution system (CI/CD). In addition, a <em>dSYM</em> file is unique for each build of the app uploaded. Therefore, we need to store the <em>dSYM</em> file from every build for this translation purpose.</p><h4>3. Symbolicatecrash</h4><p><em>Symbolicatecrash</em> is a command that will translate the <em>.ips</em> file by combining it with the suitable <em>dSYM</em> and device symbol. This command can be accessed inside the Xcode through this path.</p><pre>Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/</pre><p>In iOS Tokopedia, we bundle it to a single bash script so that we can execute it as a single command through a terminal. Once we successfully perform this magical process, <em>voila!</em> Now, as shown in the snippet below, we can read the crash log and determine its root cause.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0d9b3bf0b6230c7162c724840540522e/href">https://medium.com/media/0d9b3bf0b6230c7162c724840540522e/href</a></iframe><p>It is important to note that each component needed to translate a <em>.ips</em> file must be suitable. We will get a partially translated crash log instead if any of them is incorrect. For example, if we provide a wrong device symbol, it will result in untranslated operating system frameworks, like the snippet here.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5609dc8c13d2f79ffb8b76564b7edf4e/href">https://medium.com/media/5609dc8c13d2f79ffb8b76564b7edf4e/href</a></iframe><p>The same thing will happen if the <em>dSYM</em> file is incorrect, in which the app frameworks will not translate, like this one.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/78a4a1537567f213e9dd7c0afbfea948/href">https://medium.com/media/78a4a1537567f213e9dd7c0afbfea948/href</a></iframe><p>And in the worst possible scenario, the <em>.ips</em> file is not translated at all.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*G8JKqi6-SeYivtjBuF6ojA.png" /></figure><h3>Where To Go From Here</h3><p>Now, we know how to translate a <em>.ips</em> file into a readable crash log, which will help us in our debugging process. But, can we go even further? The answer is definitely yes! In iOS Tokopedia, we decided to build this flow as a service to hasten our debugging process, especially in the development environment. Then, we connect it to our app distribution system so that whenever a new development build is created, its <em>dSYM</em> file will automatically be uploaded.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mfmMJ7s-w3ZhSa2vAzNctw.png" /><figcaption>Illustration of the service flow</figcaption></figure><p>This service allows people to upload their encoded crash logs, and they will receive the readable stack trace as a result. Therefore, if someone finds a crash on a particular development build, they only need to upload the <em>.ips</em> file and share the translated one with the developers directly, without manually obtaining and uploading the <em>dSYM</em> file for each build. As a result, developers can focus more on fixing the root cause instead of replicating the crash.</p><p>In iOS Tokopedia, we call this the <strong><em>Symboligator </em></strong>service. Why Symboligator, you said? Well, that’s something we cannot share 😉 (<em>psst</em>, trust me, it is irrelevant). You can have a deeper look at that service through this <a href="https://priorart.ip.com/IPCOM/000267878">link</a>.</p><h3>Let’s Wrap It Up</h3><p>Crashes during app development are something that we can’t avoid, but we can certainly try to minimize them by finding and understanding the root cause. Having clear information on how the crash occurs will save us more time on the debugging process, and we can focus more on fixing the issue. By utilizing the tools at hand, we might be able to create a crash log translation service that fits our needs.</p><h3>Credits</h3><p>Last but not least, a big shout-out to these peeps, <a href="https://medium.com/u/6eb525c76fd4">Edho Prasetyo</a> and <a href="https://medium.com/u/d604a68844bb">Gavrila Tiominar Sianturi</a>, that have been relentlessly working together on this service. Also, special thanks to <a href="https://medium.com/u/aac7941d4db8">Digital Khrisna</a> and <a href="https://medium.com/u/112dc9f0a01f">Ambar Dwi Septian</a> for the constant guidance and feedback throughout the whole process 🍻.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*q_UJdPykSLK3eFP60KwdDA.png" /></figure><p>As always, we have an opening at Tokopedia.<br>We are an Indonesian technology company with a mission to democratize commerce through technology and help everyone achieve more.<br>Find your Dream Job with us in Tokopedia!<br><a href="https://www.tokopedia.com/careers/">https://www.tokopedia.com/careers/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8cbd614fe88b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/tokopedia-engineering/facilitate-your-ios-crash-log-translation-for-numerous-builds-8cbd614fe88b">Facilitate Your iOS Crash Log Translation For Numerous Builds</a> was originally published in <a href="https://medium.com/tokopedia-engineering">Tokopedia Engineering</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>