Skip to content

Commit 1acb849

Browse files
committed
Update README
1 parent 72a0070 commit 1acb849

File tree

1 file changed

+38
-13
lines changed

1 file changed

+38
-13
lines changed

README.md

+38-13
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,9 @@
11
# OpenSwiftUI
22

3-
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FOpenSwiftUIProject%2FOpenSwiftUI%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/OpenSwiftUIProject/OpenSwiftUI)
4-
5-
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FOpenSwiftUIProject%2FOpenSwiftUI%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/OpenSwiftUIProject/OpenSwiftUI)
6-
7-
[![codecov](https://codecov.io/gh/OpenSwiftUIProject/OpenSwiftUI/graph/badge.svg?token=S63P3YUCAJ)](https://codecov.io/gh/OpenSwiftUIProject/OpenSwiftUI)
3+
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FOpenSwiftUIProject%2FOpenSwiftUI%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/OpenSwiftUIProject/OpenSwiftUI) [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FOpenSwiftUIProject%2FOpenSwiftUI%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/OpenSwiftUIProject/OpenSwiftUI) [![codecov](https://codecov.io/gh/OpenSwiftUIProject/OpenSwiftUI/graph/badge.svg?token=S63P3YUCAJ)](https://codecov.io/gh/OpenSwiftUIProject/OpenSwiftUI)
84

95
OpenSwiftUI is an open source implementation of Apple's [SwiftUI](https://developer.apple.com/documentation/swiftui)
106

11-
| **CI Status** |
12-
|---|
13-
|[![Compatibility tests](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/compatibility_tests.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/compatibility_tests.yml)|
14-
|[![macOS](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/macos.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/macos.yml)|
15-
|[![iOS](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml)|
16-
|[![Ubuntu](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml)|
17-
|[![Wasm](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/wasm.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/wasm.yml)|
18-
197
The project is for the following purposes:
208
- Build GUI app on non-Apple platform (eg. Linux & Windows)
219
- Diagnose and debug SwfitUI issues on Apple platform
@@ -24,6 +12,15 @@ And the API design is to stay the same as the original SwiftUI API as possible.
2412

2513
Currently, this project is in early development.
2614

15+
You can find the API [documentation](https://swiftpackageindex.com/OpenSwiftUIProject/OpenSwiftUI/main/documentation/openswiftui) here.
16+
17+
> [!IMPORTANT]
18+
> Please **DO NOT** use this package in production environment on Apple platform
19+
> (eg. App Store and Mac App Store) since this package use a lot of hidden and
20+
> private API here.
21+
>
22+
> It may break your build or crash your app at any future SDK/OS update.
23+
2724
## Usage
2825

2926
See Example folder and try it with ExampleApp
@@ -42,6 +39,34 @@ See Example folder and try it with ExampleApp
4239
./Scripts/openswiftui_swiftinterface
4340
```
4441

42+
## Supported platforms
43+
44+
The table below describes the current level of support that `OpenSwiftUI` has
45+
for various platforms:
46+
47+
| **Platform** | **CI Status** | **Support Status** | Build | Test | Deploy |
48+
|-|:-|-|-|-|-|
49+
| **macOS** | [![macOS](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/macos.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/macos.yml) [![Compatibility tests](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/compatibility_tests.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/compatibility_tests.yml) | ⭐️⭐️⭐️ *[^1] ||||
50+
| **iOS** | [![iOS](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml) | ⭐️⭐️⭐️⭐️ *[^2] ||||
51+
| **Ubuntu 22.04** | [![Ubuntu](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml) | ⭐️⭐️ *[^3] ||||
52+
| **Wasm** | [![Ubuntu](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml) | ⭐️ *[^4] ||||
53+
| **Windows** | | Not supported yet ||||
54+
55+
56+
[^1]: AppKit and other UI framework backend is not intergrated yet.
57+
58+
[^2]: UIKit intergration is partly implemented. No Render support yet.
59+
60+
[^3]: Build and test is supported. But some feature is cut due to known Swift compiler issue.
61+
62+
[^4]: Build is supported. Test is not supported yet dut to upstream issue.
63+
64+
> [!NOTE]
65+
> Due to the current limited implementation level of OpenGraph.
66+
> It is only API compatible with AttributeGraph.
67+
>
68+
> Most of the core feature is only available on Apple platform built with AttributeGraph varient.
69+
4570
## License
4671

4772
See LICENSE file - MIT

0 commit comments

Comments
 (0)