Skip to content

Commit 0394c98

Browse files
committed
Update README
1 parent 72a0070 commit 0394c98

File tree

1 file changed

+36
-13
lines changed

1 file changed

+36
-13
lines changed

README.md

+36-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,32 @@ 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** |
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) | ⭐️⭐️⭐️ Supported *[^1] |
50+
| **iOS** | [![iOS](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ios.yml) | ⭐️⭐️⭐️⭐️ Supported *[^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) | ⭐️⭐️ Build Supported *[^3] |
52+
| **Wasm** | [![Ubuntu](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/OpenSwiftUIProject/OpenSwiftUI/actions/workflows/ubuntu.yml) | ⭐️ Build Supported *[^4] |
53+
54+
[^1]: AppKit and other UI framewokr backend is not implemented yet.
55+
56+
[^2]: UIKit intergration is parted implemented. No Render support yet.
57+
58+
[^3]: Build and test is supported. But some feature is cut due to known Swift compiler issue.
59+
60+
[^4]: Build is supported. Test is not supported yet.
61+
62+
> [!NOTE]
63+
> Due to the current limited implementation level of OpenGraph.
64+
> It is only API compatible with AttributeGraph.
65+
>
66+
> Most of the core feature is only available on Apple platform built with AttributeGraph varient.
67+
4568
## License
4669

4770
See LICENSE file - MIT

0 commit comments

Comments
 (0)