diff --git a/orderfile/README.md b/orderfile/README.md
new file mode 100644
index 000000000..8fb0474aa
--- /dev/null
+++ b/orderfile/README.md
@@ -0,0 +1,100 @@
+# Order file demo
+
+Order files are text files containing symbols representing functions names.
+Linkers (lld) uses order files to layout functions in a specific order. These
+binaries with ordered symbols will reduce page faults and improve a program's
+launch time due to the efficient loading of symbols during a program’s
+cold-start.
+
+## Files
+
+- app/src/main/cpp/orderfile.cpp: The source code for the orderfile library that
+ is used by the Kotlin app.
+- app/src/main/cpp/CMakeLists.txt: The CMakeLists either sets the orderfile
+ library as generating profiles or loading the orderfile.
+- app/src/main/java/MainActivity.kt: The Kotlin app source code.
+
+## Profile Steps
+
+1. For simplicity, we have setup the `CMakeLists.txt` and you just need make
+ sure `set(GENERATE_PROFILES ON)` is not commented. You need to pass any
+ optimization flag except `-O0`. The mapping file is not generated and the
+ profile instrumentation does not work without an optimization flag.
+1. Run the app on Android Studio. You can either run it on a physical or virtual
+ device. You will see "Hello World" on the screen.
+1. To pull the data from the device, you'll need to move it from an app-writable
+ directory to a shell readable directory for adb pull. We also need to
+ transfer the output into hexadecimal format.
+
+```
+adb shell "run-as com.example.orderfiledemo sh -c 'cat /data/user/0/com.example.orderfiledemo/cache/demo.output.order' | cat > /data/local/tmp/demo.output.order"
+adb pull /data/local/tmp/demo.output.order .
+
+# Convert to hexdeciaml format on Linux, Mac, or ChromeOS
+hexdump -C demo.output.order > demo.prof
+
+# Convert to hexdecimal format on Windows
+certutil -f -encodeHex demo.output.order demo.prof
+```
+
+4. Once you get both mapping file and profile file, you can use
+ [this script](https://android.googlesource.com/toolchain/pgo-profiles/+/refs/heads/main/scripts/create_orderfile.py)
+ to create the order file:
+
+```
+python3 create_orderfile.py --profile-file demo.prof --mapping-file mapping.txt --output app/src/main/cpp/demo.orderfile
+```
+
+## Load Steps
+
+1. For load, you need to uncomment
+ `set(USE_PROFILE "${CMAKE_SOURCE_DIR}/demo.orderfile")` and make sure
+ `set(GENERATE_PROFILES ON)` is commented.
+
+1. If you want to validate the shared library's layout is different, you need to
+ find `liborderfiledemo.so` and run `nm`
+
+```
+nm -n liborderfiledemo.so
+```
+
+## Difference between Java and Kotlin App
+
+The main difference between a Java app and a Kotlin app is the syntax. You can
+easily change this Kotlin example into a Java example.
+
+- Load Library
+
+```
+# Kotlin
+companion object {
+ init {
+ System.loadLibrary("orderfiledemo")
+ }
+}
+
+# Java
+static {
+ System.loadLibrary("orderfiledemo");
+}
+```
+
+- Recognize an external method
+
+```
+# Kotlin
+external fun runWorkload(tempDir: String)
+
+# Java
+private native void runWorkload(String tempDir);
+```
+
+- Get the cache directory
+
+```agsl
+# Kotlin
+runWorkload(applicationContext.cacheDir.toString())
+
+# Java
+runWorkload(getcacheDir().toString())
+```
diff --git a/orderfile/app/.gitignore b/orderfile/app/.gitignore
new file mode 100644
index 000000000..796b96d1c
--- /dev/null
+++ b/orderfile/app/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/orderfile/app/build.gradle b/orderfile/app/build.gradle
new file mode 100644
index 000000000..67a66fde5
--- /dev/null
+++ b/orderfile/app/build.gradle
@@ -0,0 +1,60 @@
+plugins {
+ id 'com.android.application'
+ id 'kotlin-android'
+}
+
+android {
+ compileSdk 31
+
+ defaultConfig {
+ applicationId "com.example.orderfiledemo"
+ minSdk 21
+ targetSdk 31
+ versionCode 1
+ versionName "1.0"
+ ndkVersion '25.2.9519653'
+
+ testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+ externalNativeBuild {
+ cmake {
+ cppFlags ''
+ }
+ }
+ }
+
+ buildTypes {
+ release {
+ minifyEnabled false
+ proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+ }
+ }
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+ kotlinOptions {
+ jvmTarget = '1.8'
+ }
+ externalNativeBuild {
+ cmake {
+ path file('src/main/cpp/CMakeLists.txt')
+ version '3.22.1'
+ }
+ }
+ buildFeatures {
+ viewBinding true
+ }
+ namespace 'com.example.orderfiledemo'
+ ndkVersion '25.2.9519653'
+}
+
+dependencies {
+
+ implementation 'androidx.core:core-ktx:1.3.2'
+ implementation 'androidx.appcompat:appcompat:1.2.0'
+ implementation 'com.google.android.material:material:1.3.0'
+ implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
+ testImplementation 'junit:junit:4.+'
+ androidTestImplementation 'androidx.test.ext:junit:1.1.2'
+ androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
+}
diff --git a/orderfile/app/proguard-rules.pro b/orderfile/app/proguard-rules.pro
new file mode 100644
index 000000000..f1b424510
--- /dev/null
+++ b/orderfile/app/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
diff --git a/orderfile/app/src/androidTest/java/com/example/orderfiledemo/ExampleInstrumentedTest.kt b/orderfile/app/src/androidTest/java/com/example/orderfiledemo/ExampleInstrumentedTest.kt
new file mode 100644
index 000000000..e1c097197
--- /dev/null
+++ b/orderfile/app/src/androidTest/java/com/example/orderfiledemo/ExampleInstrumentedTest.kt
@@ -0,0 +1,24 @@
+package com.example.orderfiledemo
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+ @Test
+ fun useAppContext() {
+ // Context of the app under test.
+ val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+ assertEquals("com.example.orderfiledemo", appContext.packageName)
+ }
+}
diff --git a/orderfile/app/src/main/AndroidManifest.xml b/orderfile/app/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..80d99f8d7
--- /dev/null
+++ b/orderfile/app/src/main/AndroidManifest.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/orderfile/app/src/main/cpp/CMakeLists.txt b/orderfile/app/src/main/cpp/CMakeLists.txt
new file mode 100644
index 000000000..763868625
--- /dev/null
+++ b/orderfile/app/src/main/cpp/CMakeLists.txt
@@ -0,0 +1,25 @@
+cmake_minimum_required(VERSION 3.22.1)
+project(OrderfileDemo CXX)
+
+# We have setup build variables that you can just comment or uncomment to use.
+# Make sure to have only one build variable uncommented at a time.
+# If you want to generate profiles and mapping file, make sure GENERATE_PROFILES is uncommented.
+# If you want to use your generated order file to layout symbols, uncomment USE_PROFILE.
+
+
+set(GENERATE_PROFILES ON)
+#set(USE_PROFILE "${CMAKE_SOURCE_DIR}/demo.orderfile")
+
+add_library(orderfiledemo SHARED orderfile.cpp)
+target_link_libraries(orderfiledemo log)
+
+if(GENERATE_PROFILES)
+ # Generating profiles requires any optimization flag aside from -O0.
+ # The mapping file will not generate and the profile instrumentation does not work without an optimization flag.
+ target_compile_options(orderfiledemo PRIVATE -forder-file-instrumentation -O1 -mllvm -orderfile-write-mapping=mapping.txt )
+ target_link_options(orderfiledemo PRIVATE -forder-file-instrumentation )
+ target_compile_definitions(orderfiledemo PRIVATE GENERATE_PROFILES)
+elseif(USE_PROFILE)
+ target_compile_options(orderfiledemo PRIVATE -Wl,--symbol-ordering-file=${USE_PROFILE} -Wl,--no-warn-symbol-ordering )
+ target_link_options(orderfiledemo PRIVATE -Wl,--symbol-ordering-file=${USE_PROFILE} -Wl,--no-warn-symbol-ordering )
+endif()
\ No newline at end of file
diff --git a/orderfile/app/src/main/cpp/orderfile.cpp b/orderfile/app/src/main/cpp/orderfile.cpp
new file mode 100644
index 000000000..a8e5c83ce
--- /dev/null
+++ b/orderfile/app/src/main/cpp/orderfile.cpp
@@ -0,0 +1,54 @@
+#include
+#include
+#include
+#include
+#include
+#include
+
+const char kLogTag[] = "orderfiledemo";
+
+#ifdef GENERATE_PROFILES
+extern "C" int __llvm_profile_set_filename(const char *);
+extern "C" int __llvm_profile_initialize_file(void);
+extern "C" int __llvm_orderfile_dump(void);
+#endif
+
+void DumpProfileDataIfNeeded(const char *temp_dir) {
+#ifdef GENERATE_PROFILES
+ char profile_location[PATH_MAX] = {};
+ snprintf(profile_location, sizeof(profile_location), "%s/demo.output",
+ temp_dir);
+ if (__llvm_profile_set_filename(profile_location) == -1) {
+ __android_log_print(ANDROID_LOG_ERROR, kLogTag,
+ "__llvm_profile_set_filename(\"%s\") failed: %s",
+ profile_location, strerror(errno));
+ return;
+ }
+
+ if (__llvm_profile_initialize_file() == -1) {
+ __android_log_print(ANDROID_LOG_ERROR, kLogTag,
+ "__llvm_profile_initialize_file failed: %s",
+ strerror(errno));
+ return;
+ }
+
+ if (__llvm_orderfile_dump() == -1) {
+ __android_log_print(ANDROID_LOG_ERROR, kLogTag,
+ "__llvm_orderfile_dump() failed: %s", strerror(errno));
+ return;
+ }
+ __android_log_print(ANDROID_LOG_DEBUG, kLogTag, "Wrote profile data to %s",
+ profile_location);
+#else
+ __android_log_print(ANDROID_LOG_DEBUG, kLogTag,
+ "Did not write profile data because the app was not "
+ "built for profile generation");
+#endif
+}
+
+extern "C" JNIEXPORT void JNICALL
+Java_com_example_orderfiledemo_MainActivity_runWorkload(JNIEnv *env,
+ jobject /* this */,
+ jstring temp_dir) {
+ DumpProfileDataIfNeeded(env->GetStringUTFChars(temp_dir, 0));
+}
diff --git a/orderfile/app/src/main/java/com/example/orderfiledemo/MainActivity.kt b/orderfile/app/src/main/java/com/example/orderfiledemo/MainActivity.kt
new file mode 100644
index 000000000..2523b6c1b
--- /dev/null
+++ b/orderfile/app/src/main/java/com/example/orderfiledemo/MainActivity.kt
@@ -0,0 +1,32 @@
+package com.example.orderfiledemo
+
+import androidx.appcompat.app.AppCompatActivity
+import android.os.Bundle
+import com.example.orderfiledemo .databinding.ActivityMainBinding
+
+class MainActivity : AppCompatActivity() {
+
+ private lateinit var binding: ActivityMainBinding
+
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+
+ binding = ActivityMainBinding.inflate(layoutInflater)
+ setContentView(binding.root)
+ runWorkload(applicationContext.cacheDir.toString())
+ binding.sampleText.text = "Hello, world!"
+ }
+
+ /**
+ * A native method that is implemented by the 'orderfiledemo' native library,
+ * which is packaged with this application.
+ */
+ external fun runWorkload(tempDir: String)
+
+ companion object {
+ // Used to load the 'orderfiledemo' library on application startup.
+ init {
+ System.loadLibrary("orderfiledemo")
+ }
+ }
+}
diff --git a/orderfile/app/src/main/res/drawable-v24/ic_launcher_foreground.xml b/orderfile/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 000000000..7706ab9e6
--- /dev/null
+++ b/orderfile/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,30 @@
+
+
+
+
+