2019-06-25 23:30:43 +00:00
|
|
|
# ![Ruffle](https://ruffle.rs/assets/logo.png)
|
2019-06-26 00:12:02 +00:00
|
|
|
[![CircleCI](https://circleci.com/gh/ruffle-rs/ruffle.svg?style=svg)](https://circleci.com/gh/ruffle-rs/ruffle)
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-05-08 16:46:19 +00:00
|
|
|
Ruffle is an Adobe Flash Player emulator written in Rust.
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-05-16 17:10:32 +00:00
|
|
|
## Building
|
|
|
|
|
|
|
|
[Follow the official guide](https://www.rust-lang.org/tools/install) to install Rust for your platform.
|
|
|
|
|
|
|
|
### Desktop
|
|
|
|
|
2019-05-16 17:31:23 +00:00
|
|
|
* `cargo run --package=ruffle_desktop -- test.swf`
|
2019-05-16 17:10:32 +00:00
|
|
|
|
|
|
|
### Web
|
|
|
|
|
|
|
|
* Install [Node.js](https://nodejs.org/en/)
|
|
|
|
* Install [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/)
|
2019-06-25 18:27:04 +00:00
|
|
|
|
|
|
|
#### Running the web demo
|
|
|
|
|
|
|
|
* `cd web/demo`
|
|
|
|
* `npm install`
|
|
|
|
* `npm run serve`
|
2019-05-16 18:16:53 +00:00
|
|
|
* Load indicated page in browser (usually http://localhost:8080)
|
2019-05-16 17:10:32 +00:00
|
|
|
|
2019-06-25 18:27:04 +00:00
|
|
|
#### Building the NPM package
|
|
|
|
|
|
|
|
* `cd web`
|
|
|
|
* `wasm-pack build`
|
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
## Structure
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
- `core` contains the core emulator and common code
|
|
|
|
- `desktop` contains the desktop client (uses `glium`)
|
|
|
|
- `web` contains the web client (uses `wasm-bindgen`)
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
## License
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
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.
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
### Contribution
|
2019-04-25 17:52:22 +00:00
|
|
|
|
2019-04-28 06:26:04 +00:00
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
|
|
for inclusion in the work by you shall be dual licensed as above, without any
|
2019-05-01 16:36:43 +00:00
|
|
|
additional terms or conditions.
|