{"id":46652,"date":"2020-03-19T10:35:42","date_gmt":"2020-03-19T17:35:42","guid":{"rendered":"http:\/\/devblogs.microsoft.com\/xamarin\/?p=46652"},"modified":"2020-03-24T12:05:29","modified_gmt":"2020-03-24T19:05:29","slug":"faster-android-startup-times-with-startup-tracing","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/faster-android-startup-times-with-startup-tracing\/","title":{"rendered":"Faster Application Startup using Custom Profiles with Startup Tracing on Android"},"content":{"rendered":"

In our efforts to bring you extremely fast startup times on Android, we’re bringing you the ability to record your own profiles to use with startup tracing on Android.<\/p>\n

What is a custom profile?<\/h2>\n

A custom profile is a profile that is generated based on running an embedded profiler against your application to find out which methods are JIT compiled during the startup. The custom profile can then be used in your release application to get your users into your app even faster.<\/p>\n

Requirements<\/h2>\n

To use custom profiles with startup tracing on Android, you’ll need Visual Studio 16.5+ or Visual Studio for Mac 8.5+.<\/p>\n

Download Visual Studio Preview<\/a><\/div>\n
Download Visual Studio for Mac Preview<\/a><\/div>\n

Getting Started<\/h2>\n

Today, you can get started using custom profiles with startup tracing via the command line and MSBuild. In a future version of Visual Studio, you will be able to record custom profiles inside the IDE!<\/p>\n

    \n
  1. Open a command prompt or terminal against your Android project’s directory that contains the .csproj<\/code>.<\/li>\n
  2. Ensure only one Android device is attached.<\/li>\n
  3. Under the app’s\u00a0Android Manifest > Required permissions<\/strong>\u00a0in the Visual Studio project property pages, ensure the\u00a0INTERNET<\/strong>\u00a0permission is enabled.<\/li>\n
  4. msbuild \/t:BuildAndStartAotProfiling<\/code><\/li>\n
  5. Let your application run until it’s loaded.<\/li>\n
  6. msbuild \/t:FinishAotProfiling<\/code><\/li>\n
  7. This will add a custom.aprof file to your project which you’ll want to change the Build Action<\/code> to AndroidAotProfile<\/code>. You can do this by adding the following <ItemGroup><\/code> to your .csproj<\/code>:<ItemGroup> <AndroidAotProfile Include=\"$(MSBuildThisFileDirectory)custom.aprof\" \/> <\/ItemGroup><\/code>\"Image<\/li>\n
  8. Finally, you’ll need to include two MSBuild properties to your Release<\/code> configuration to enable the feature and use the custom profile.<\/li>\n<\/ol>\n

    <PropertyGroup> <AndroidEnableProfiledAot>true<\/AndroidEnableProfiledAot> <AndroidUseDefaultAotProfile>false<\/AndroidUseDefaultAotProfile> <\/PropertyGroup><\/code><\/p>\n

    Note:<\/strong> On Windows, you can use Developer Command Prompt for Visual Studio(Tools > Command Line > Developer Command Prompt<\/strong>). This is especially helpful for side by side installations of Visual Studio.<\/p>\n

    Differences in Startup Tracing Modes<\/h2>\n

    You can see the differences in startup tracing modes against a larger Xamarin.Forms application. The measurements below were collected against the SmartHotel360<\/a> repository.<\/p>\n\n\n\n\n\n
    <\/td>\nRelease<\/td>\nRelease\/AOT<\/td>\nRelease\/Startup Tracing (Default)<\/td>\nRelease\/Startup Tracing(Custom)<\/td>\n<\/tr>\n
    Activity Displayed<\/td>\n4863ms<\/td>\n2086ms<\/td>\n3655ms<\/td>\n1900ms<\/td>\n<\/tr>\n
    APK Size<\/td>\n48MB<\/td>\n95MB<\/td>\n57MB<\/td>\n60MB<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Custom profiles has the most optimal startup performance with a minimal overhead to APK size!<\/p>\n

    For more details on profiling your applications using our embedded profiler, see our documentation.<\/a><\/p>\n

    Inspecting AOT Profiles<\/h2>\n

    The AOT profiles generated by the profiler can be analyzed and\/or filtered by the aprofutil<\/code> tool.<\/p>\n

    To get started with this tool, run the aprofutil<\/code> tool with the -s<\/code> (summary) argument against your generated .aprof<\/code> profile.<\/p>\n

    For example:<\/p>\n

    aprofutil -s SmartHotel.Clients.Android\/custom.aprof<\/code><\/p>\n

    Summary:\r\n\tModules: 50\r\n\tTypes: 1,750\r\n\tMethods: 7,940\r\n<\/code><\/pre>\n
    For more information regarding using the aprofutil<\/code> tool, see the documentation.<\/a><\/p>\n
    Note:<\/strong> Because this tool uses adb<\/code>, you will want to ensure adb<\/code> is on your environment path. It can be found in your Android SDK’s\u00a0android-sdk\\platform-tools<\/span>\u00a0 directory.<\/p>\n
    Summary<\/h2>\n
    Now you can record and use custom profiles when using startup tracing on Android. This provides you the most optimal application startup time with a slight increase to APK size.<\/p>\n
    In the future, you will be able to record profiles within Visual Studio and Visual Studio for Mac.<\/p>\n
    We can’t wait to see how this feature improves your application’s startup times.<\/p>\n
    Also, don’t forget to check out Ryan Davis’s excellent blog article on Using Custom AOT Profiles with Xamarin.Android<\/a>, where he goes through using this feature within his apps!<\/p>\n
    Feedback<\/h2>\n
    We\u2019re continuously improving this experience and want to know your thoughts on it! For anything you believe is an issue with Startup Tracing with Android apps, please\u00a0file an issue on Developer Community.<\/a><\/p>\n
    Additionally,\u00a0let us know if you have any suggestions<\/a>\u00a0for how we can improve the Startup Tracing experience.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Developers today can already take advantage of Startup Tracing to improve the startup time of their Android apps. Today, I will show you a new feature that let’s you build a custom profile to be used for your app with Startup Tracing that finely tunes and optimizes your apps startup.<\/p>\n","protected":false},"author":551,"featured_media":46653,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[313,2,1,367],"tags":[5,8234,8235,6291,6290],"class_list":["post-46652","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-android","category-developers","category-xamarin","category-xamarin-forms","tag-android","tag-boot-time","tag-custom-profiles","tag-startup-time","tag-startup-tracing"],"acf":[],"blog_post_summary":"
    Developers today can already take advantage of Startup Tracing to improve the startup time of their Android apps. Today, I will show you a new feature that let’s you build a custom profile to be used for your app with Startup Tracing that finely tunes and optimizes your apps startup.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/46652","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/551"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=46652"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/46652\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media\/46653"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=46652"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=46652"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=46652"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}