summaryrefslogtreecommitdiff
path: root/vendor/android_system_properties/README.md
diff options
context:
space:
mode:
authormo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
committermo khan <mo@mokhan.ca>2025-07-02 18:36:06 -0600
commit8cdfa445d6629ffef4cb84967ff7017654045bc2 (patch)
tree22f0b0907c024c78d26a731e2e1f5219407d8102 /vendor/android_system_properties/README.md
parent4351c74c7c5f97156bc94d3a8549b9940ac80e3f (diff)
chore: add vendor directory
Diffstat (limited to 'vendor/android_system_properties/README.md')
-rw-r--r--vendor/android_system_properties/README.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/vendor/android_system_properties/README.md b/vendor/android_system_properties/README.md
new file mode 100644
index 00000000..46f6500b
--- /dev/null
+++ b/vendor/android_system_properties/README.md
@@ -0,0 +1,36 @@
+# android_system_properties
+
+A thin rust wrapper for Android system properties.
+
+This crate is similar to the `android-properties` crate with the exception that
+the necessary Android libc symbols are loaded dynamically instead of linked
+statically. In practice this means that the same binary will work with old and
+new versions of Android, even though the API for reading system properties changed
+around Android L.
+
+## Example
+
+```rust
+use android_system_properties::AndroidSystemProperties;
+
+let properties = AndroidSystemProperties::new();
+
+if let Some(value) = properties.get("persist.sys.timezone") {
+ println!("{}", value);
+}
+```
+
+## Listing and setting properties
+
+For the sake of simplicity this crate currently only contains what's needed by wgpu.
+The implementations for listing and setting properties can be added back if anyone needs
+them (let me know by filing an issue).
+
+## License
+
+Licensed under either of
+
+ * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
+ * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
+
+at your option.