macos: docs++

Author: mhils

mitmproxy-macos/README.md

@@ -8,4 +8,10 @@ This package contains the following precompiled binaries for macOS:
 ## Redirector Development Setup
 
 The macOS Network System Extension needs to be signed and notarized during development.
-You need to reconfigure the XCode project to use your own (paid) Apple Developer Account.
+You need to reconfigure the XCode project to use your own (paid) Apple Developer Account.
+
+- Clicking "Build" in XCode should automatically install `/Applications/Mitmproxy Redirector.app`.
+- Run mitmproxy with an `MITMPROXY_KEEP_REDIRECTOR=1` env var to keep the development version.
+  mitmproxy should start with "Using existing mitmproxy redirector app."
+- ⚠️ Bump the network extension version on changes, otherwise existing installations will not be replaced
+  on upgrade, see https://github.com/mitmproxy/mitmproxy_rs/pull/227.

src/ipc/mitmproxy_ipc.proto

@@ -25,24 +25,29 @@ message FromProxy {
   }
 }
 // Packet (macOS UDP Stream)
+// ⚠️ Bump network extension version on changes, https://github.com/mitmproxy/mitmproxy_rs/pull/227.
 message Packet {
   bytes data = 1;
 }
 // Intercept conf (macOS Control Stream)
+// ⚠️ Bump network extension version on changes, https://github.com/mitmproxy/mitmproxy_rs/pull/227.
 message InterceptConf {
   repeated string actions = 1;
 }
 // New flow (macOS TCP/UDP Stream)
+// ⚠️ Bump network extension version on changes, https://github.com/mitmproxy/mitmproxy_rs/pull/227.
 message NewFlow {
   oneof message {
     TcpFlow tcp = 1;
     UdpFlow udp = 2;
   }
 }
+// ⚠️ Bump network extension version on changes, https://github.com/mitmproxy/mitmproxy_rs/pull/227.
 message TcpFlow {
   Address remote_address = 1;
   TunnelInfo tunnel_info = 2;
 }
+// ⚠️ Bump network extension version on changes, https://github.com/mitmproxy/mitmproxy_rs/pull/227.
 message UdpFlow {
   optional Address local_address = 1;
   TunnelInfo tunnel_info = 3;