finish top level android directory files

trace.odin

@@ -0,0 +1,72 @@
+//+build android
+package android
+
+foreign import android "system:android"
+
+foreign android {
+	/**
+	 * Returns true if tracing is enabled. Use this to avoid expensive computation only necessary
+	 * when tracing is enabled.
+	 *
+	 * Available since API level 23.
+	 */
+	ATrace_isEnabled :: proc() -> bool ---
+
+	/**
+	 * Writes a tracing message to indicate that the given section of code has begun. This call must be
+	 * followed by a corresponding call to {@link ATrace_endSection} on the same thread.
+	 *
+	 * Note: At this time the vertical bar character '|' and newline character '\\n' are used internally
+	 * by the tracing mechanism. If \p sectionName contains these characters they will be replaced with a
+	 * space character in the trace.
+	 *
+	 * Available since API level 23.
+	 */
+	ATrace_beginSection :: proc(sectionName: cstring) ---
+
+	/**
+	 * Writes a tracing message to indicate that a given section of code has ended. This call must be
+	 * preceeded by a corresponding call to {@link ATrace_beginSection} on the same thread. Calling this method
+	 * will mark the end of the most recently begun section of code, so care must be taken to ensure
+	 * that {@link ATrace_beginSection}/{@link ATrace_endSection} pairs are properly nested and called from the same thread.
+	 *
+	 * Available since API level 23.
+	 */
+	ATrace_endSection :: proc() ---
+
+	/**
+	 * Writes a trace message to indicate that a given section of code has
+	 * begun. Must be followed by a call to {@link ATrace_endAsyncSection} with the same
+	 * methodName and cookie. Unlike {@link ATrace_beginSection} and {@link ATrace_endSection},
+	 * asynchronous events do not need to be nested. The name and cookie used to
+	 * begin an event must be used to end it.
+	 *
+	 * Available since API level 29.
+	 *
+	 * \param sectionName The method name to appear in the trace.
+	 * \param cookie Unique identifier for distinguishing simultaneous events
+	 */
+	ATrace_beginAsyncSection :: proc(sectionName: cstring, cookie: i32) ---
+
+	/**
+	 * Writes a trace message to indicate that the current method has ended.
+	 * Must be called exactly once for each call to {@link ATrace_beginAsyncSection}
+	 * using the same name and cookie.
+	 *
+	 * Available since API level 29.
+	 *
+	 * \param sectionName The method name to appear in the trace.
+	 * \param cookie Unique identifier for distinguishing simultaneous events
+	 */
+	ATrace_endAsyncSection :: proc(sectionName: cstring, cookie: i32) ---
+
+	/**
+	 * Writes trace message to indicate the value of a given counter.
+	 *
+	 * Available since API level 29.
+	 *
+	 * \param counterName The counter name to appear in the trace.
+	 * \param counterValue The counter value.
+	 */
+	ATrace_setCounter :: proc(counterName: cstring, counterValue: i64) ---
+}