mirror of
https://github.com/awatertrevi/xamarin-neo4j.git
synced 2026-09-22 09:05:29 +00:00
fb361f0f4c
Mirrors lojack-connect. .NET for Android runs no DEX shrinker by default, and even with AndroidLinkTool=r8 the ProGuard config the SDK generates hardcodes -dontobfuscate -- a flag nothing later in the config list can undo -- so Play Console's "DEX code optimization" report scores obfuscation at ~1%. _AndroidObfuscateDex drops the SDK's proguard_xamarin.cfg from R8's --pg-conf list and substitutes a copy without that line, regenerating the -printmapping/-keepattributes tail the SDK would have appended (absolute path: R8 resolves a relative -printmapping against the config file's own directory). 49.8% of DEX classes are now renamed. proguard.cfg carries the keeps the generated rules miss: classes the .NET runtime resolves by name from native code (net.dot.android.**), and public and protected fields, which the trimmer covers for methods only. The target also caches aapt2's keep rules outside FileWrites -- the SDK adds them to @(ProguardConfiguration) inside _CreateBaseApkWithAapt2 and registers the file as a FileWrite, so an incremental Release build that skips the resource link loses them and ships an APK that dies inflating FitWindowsFrameLayout. Verified on a Pixel 9 emulator (API 36) with the obfuscated Release APK: launch, connection list, Add Connection form, and a Bolt connection attempt that exercises the network/TLS stack and surfaces the driver's error dialog. The AAB carries mapping.txt, so Play retraces Java stacks itself. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
108 lines
3.6 KiB
Markdown
108 lines
3.6 KiB
Markdown
# PocketGraph
|
|
|
|
A Neo4j and Memgraph client for iPhone and iPad, built with .NET MAUI.
|
|
|
|
**[pocketgraph.app](https://pocketgraph.app)**
|
|
|
|
[](https://apps.apple.com/nl/app/pocketgraph/id1604368926)
|
|
|
|
## Features
|
|
|
|
- Connect via the Bolt protocol with SSL/TLS support
|
|
- Compatible with Neo4j and Memgraph
|
|
- Interactive graph visualization with expand/collapse
|
|
- Table view for query results
|
|
- Save and manage connections and queries
|
|
- Light and dark theme
|
|
- iPhone and iPad support (iOS 14.2+)
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
Xamarin.Neo4j/
|
|
├── Xamarin.Neo4j/ # Shared .NET MAUI project
|
|
├── Xamarin.Neo4j.iOS/ # iOS platform project
|
|
├── Xamarin.Neo4j.Tests/ # Unit tests
|
|
└── Xamarin.Neo4j.IntegrationTests/ # Integration tests (Neo4j + Memgraph via Docker)
|
|
```
|
|
|
|
## Development
|
|
|
|
### Prerequisites
|
|
- .NET 10 SDK
|
|
- Xcode (for iOS builds)
|
|
- Docker (for integration tests)
|
|
|
|
### Building
|
|
|
|
```bash
|
|
cd Xamarin.Neo4j
|
|
dotnet build Xamarin.Neo4j.sln
|
|
```
|
|
|
|
### Running Tests
|
|
|
|
```bash
|
|
# Unit tests
|
|
dotnet test Xamarin.Neo4j/Xamarin.Neo4j/Xamarin.Neo4j.Tests/
|
|
|
|
# Integration tests (requires Docker)
|
|
dotnet test Xamarin.Neo4j/Xamarin.Neo4j/Xamarin.Neo4j.IntegrationTests/
|
|
```
|
|
|
|
### Android DEX shrinking & obfuscation (R8)
|
|
|
|
Release builds of the Android head run R8 over the Java/DEX side
|
|
(`AndroidLinkTool=r8` in `Xamarin.Neo4j.Android.csproj`). Play Console's *DEX code
|
|
optimization* report scores obfuscation at ~1% on a stock .NET MAUI build: .NET for
|
|
Android runs no DEX shrinker by default, and even with R8 on, the ProGuard config the
|
|
SDK generates hardcodes `-dontobfuscate` — a flag nothing later in the config list can
|
|
undo. The `_AndroidObfuscateDex` target therefore drops that file from R8's `--pg-conf`
|
|
list and substitutes `Xamarin.Neo4j.Android/proguard_xamarin.cfg` (the same file minus
|
|
that line), plus a generated file carrying the `-printmapping`/`-keepattributes` tail
|
|
the SDK would have appended. Measured on the Release APK: **49.8% of DEX classes
|
|
renamed, up from ~0%**.
|
|
|
|
Only library-internal classes are renamed: the trimmer emits a `-keep` rule for every
|
|
Java type the managed bindings reference, aapt2 one for every class named in a layout
|
|
or the manifest, and each Android Callable Wrapper gets its own.
|
|
`Xamarin.Neo4j.Android/proguard.cfg` covers what those miss — things resolved by name
|
|
from native code. Add to it if a Release build dies with `ClassNotFoundException`,
|
|
`NoSuchFieldError` or `NoSuchMethodError` where a Debug build does not.
|
|
|
|
`mapping.txt` is embedded in the AAB
|
|
(`BUNDLE-METADATA/com.android.tools.build.obfuscation/proguard.map`), so Play Console
|
|
retraces obfuscated Java stacks by itself. Managed (C#) stack traces are unaffected —
|
|
R8 only touches DEX.
|
|
|
|
Local Release builds must be clean: aapt2's keep rules are registered as a `FileWrite`,
|
|
so an incremental build that skips the resource link has `IncrementalClean` delete them.
|
|
The target caches a copy outside `FileWrites` and errors out if even that is missing —
|
|
delete `Xamarin.Neo4j.Android/obj/Release` if it fires.
|
|
|
|
## Technology Stack
|
|
|
|
- .NET MAUI
|
|
- Neo4j.Driver (Bolt protocol)
|
|
- C# / XAML
|
|
- MVVM architecture
|
|
- Testcontainers for integration testing
|
|
|
|
## Privacy
|
|
|
|
PocketGraph does not collect any user data. All connections and queries are stored locally on your device.
|
|
|
|
## About
|
|
|
|
PocketGraph is a product of [Re: Software B.V.](https://resoftware.nl).
|
|
|
|
Neo4j and Cypher are registered trademarks of Neo4j, Inc.
|
|
|
|
## License
|
|
|
|
See [LICENSE](LICENSE) for details.
|
|
|
|
## Support
|
|
|
|
Contact: support@resoftware.nl
|