Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/project-robius/makepad_taobao
TaoBao-like application implemented with Makepad
https://github.com/project-robius/makepad_taobao
makepad wasm
Last synced: about 1 month ago
JSON representation
TaoBao-like application implemented with Makepad
- Host: GitHub
- URL: https://github.com/project-robius/makepad_taobao
- Owner: project-robius
- License: apache-2.0
- Created: 2023-08-08T16:13:53.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-01T08:17:36.000Z (7 months ago)
- Last Synced: 2024-08-01T09:51:05.683Z (7 months ago)
- Topics: makepad, wasm
- Language: Rust
- Homepage: https://wasm.robius.rs/makepad_taobao
- Size: 39.2 MB
- Stars: 3
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-list - mobilerust/makepad_taobao
- awesome-rust-list - mobilerust/makepad_taobao
README
# makepad_taobao
TaoBao-like application implemented with Makepad
* currently it is mostly UI screens
* actual business logic is not implemented
## Build Instructions
## 1. Setup Makepad
### Clone the Makepad repository
```bash
cd ~
git clone [email protected]:makepad/makepad.git
```
### Change to latest development branch: 'rik'
```bash
git branch rik
```
### Install makepad subcommand for cargo
```bash
cargo install --path ~/makepad/tools/cargo_makepad
```
## 2. Get Project
### Clone the makepad_taobao repo
```bash
git clone https://github.com/project-robius/makepad_taobao
```
## 3. Android Build
### Install Android toolchain (First time)
```bash
rustup toolchain install nightly
cargo makepad android install-toolchain
```
### Install app on Android devivce or Android emulator
Open either the Android emulator or connect to a real Android device
use `adb` command to make sure there's a device connected properly
```bash
cd ~/makepad_taobao
cargo makepad android run -p makepad_taobao --release
```
## 4. iOS Setup & Install
### Install IOS toolchain (First time)
```bash
rustup toolchain install nightly
cargo makepad apple ios install-toolchain
```
### Install app on Apple devivce or iOS simulator
### iOS Setup
For iOS, the process is slightly more complicated. The steps involved are:
1. Enable your iPhone's Developer Mode, please see instructions here: [Enable Developer Mode](https://www.delasign.com/blog/how-to-turn-on-developer-mode-on-an-iphone/)
1. Setup an Apple Developer account
1. Setup an empty skeleton project in Xcode
1. File -> New -> Project to create a new "App"
1. Set the Product Name as **`makepad_taobao`** (used in --app later) (Due to Apple's name rule, the bundle id name will use hyphen - instead of underscore _)
1. Set the Organization Identifier to a value of your choice, for this example we will use **`rs.robius`** (used in --org later)
1. Setup the Project Signing & Capabilities to select the proper team account
1. In Xcode, Build/Run this project to install and run the app on the simulator and device
1. Once the simulator and device has the "skeleton" app installed and running properly, then it is ready for Makepad to install its application.
### Makepad Install
We will run the `cargo makepad apple ios` command, similar to Android build above, but there are some 2 to 6 additional parameters that need to be filled in:
`--org`
First few parts of the organization identifier (which makes up the Bundle Identifier). Usually in the form of **com.somecompany** or **org.someorg**
This is the same value used to setup the initial skeleton app above. For this example:
> `rs.robius`
`--app`
The name of the application or the project. This is the same as the Product Name used to setup the initial skeleton app above. In this case:
> `makepad-taobao`
### Install app on IOS simulator
```bash
cd ~/makepad_taobao
cargo makepad apple ios \
--org=rs.robius \
--app=makepad-taobao \
run-sim -p makepad_taobao --release
```
### Install app on IOS device
First run the following command:
```bash
cargo makepad apple list
```
This command will print out the list of all provisioning profiles, signing identities, and device identifiers on the current system. The user has to decide and choose the ones that he/she needs to use for each type. (If you get an error from the command, please follow the iOS Setup instructions above first.)
Once decided, run the folloiwng command and fill in the **unique starting characters** chosen from the output.
```bash
cd ~/makepad_taobao
cargo makepad apple ios \
--profile=unique-starting-hex-string \
--cert=UNIQUE_STARTING_HEX_STRING \
--device=UNIQUE-STARTING-HEX-STRING \
--org=rs.robius \
--app=makepad_taobao \
run-device -p makepad_taobao –release
```
## 5. WASM Build
Running the Makepad application as a WASM build is as simple as a single command. The script will automatically generate the necessary index.html and other files and also start a local webserver at port 8010.
### Demo
### Install WASM toolchain (First time)
```bash
cargo makepad wasm install-toolchain
```
### Install app as WASM binary for browsers
```bash
cargo makepad wasm run -p makepad_taobao --release
```
After running the command below, just open your browser to in order for the app to load and run.
## 6. MacOS / PC
Running on Desktop is the quickest way to try out an example app.
```bash
cd ~/makepad_taobao
cargo run
```
or
```bash
cd ~/makepad_taobao
cargo run -p makepad_taobao --release
```
And there should be a desktop application window now running (may need to click on the icon on MacOS's Dock to show it)