Add docs on working with this crate in WebAssembly

[rylev]

It is possible to use this crate in WebAssembly though one needs to turn off the default features since they link to some C libraries. We should document this.

[rambip]

It's exactly what I'm trying to do !

I'm creating a web app to compress images to jpeg and I want to bundle them in a zip folder to be able to download them.

How could I do it ?

[rambip]

I just found someone who tried to do something similar: https://github.com/Janlaywss/rust-zip-wasm/blob/main/src/lib.rs

[zamazan4ik]

@rambip I hope you already tried to build zip library to WASM. Could you share please the instruction on how to do it? I have no experience with a compilation to WASM target and any help is really appreciated.

[Tamschi]

@rambip I hope you already tried to build zip library to WASM. Could you share please the instruction on how to do it? I have no experience with a compilation to WASM target and any help is really appreciated.

For Rust projects targeting Wasm, this library can be used as normal. You can run

cargo check --target wasm32-unknown-unknown --no-default-features

to make sure it's compatible with that target. Testing in that environment is a bit more involved, but only required if you really have platform-specific cfgs where you'd like to actually run that code.

If you'd like to publish this library as stand-alone npm package (for use from JS), that's more involved and would require wrapping it appropriately. The wasm-bindgen + wasm-pack combination available at https://rustwasm.github.io/ should do the trick.

[rambip]

Here is the project I compiled zip to wasm:
https://github.com/rambip/web-compress

To compile it you just need trunk