Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bitrake/fasmg-umbrella

Umbrella libraries for modern windows development (with fasmg).
https://github.com/bitrake/fasmg-umbrella

assembly fasmg windows x86 x86-64

Last synced: about 2 months ago
JSON representation

Umbrella libraries for modern windows development (with fasmg).

Host: GitHub
URL: https://github.com/bitrake/fasmg-umbrella
Owner: bitRAKE
Created: 2022-06-16T19:56:11.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-11-23T20:36:48.000Z (2 months ago)
Last Synced: 2024-11-23T21:26:10.732Z (2 months ago)
Topics: assembly, fasmg, windows, x86, x86-64
Language: Assembly
Homepage:
Size: 3.92 MB
Stars: 7
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        > [!WARNING]

> This software is unfinished. Keep your expectations low.

# fasmg-umbrella

Umbrella libraries for modern windows development (using [fasmg](https://github.com/tgrysztar/fasmg)).

The umbrella libraries try to increase consistency in windows development, thru target selection via a single library:

	Name Suffix:

		OneCore*

			All editions of Windows 7 and later

		WindowsApps*

			Win11 app development platform, WinUI 3+

		windowscoreheadless*

			Win10+ containers, Nano Server

		mincore*

			IoT

	Name Postfix:

		*UAP

			Universal Windows Platform (UWP) editions, Win10+

			Desktop, IoT, HoloLens, but not Nano Server

		*_apiset

			access functions through apiset instead of DLL - same coverage

		*_downlevel

			?minimal support for older windows versions, driver development?

Some things to note:

---

- Not all combinations of {suffix}{postfix} exist.

- Backward compatiblity is not a goal of umbrella libraries.

---

Getting Started:

---

The only requirements are a supported windows version, and a command prompt with `git` along search path:

```bash

git clone --recursive https://github.com/bitRAKE/fasmg-umbrella

cd fasmg-umbrella

environment.cmd

```

Examples:

---

- In the `\examples` directory several small programs can be build with fasmg. A clone of the repository should be sufficient, `envionment.cmd` from a command prompt establishes the needed changs to the environment. Individual examples can be built or the `rebuild.cmd` script will build them all.

- File naming makes a distinction between several types of source code: `.asm` are main project files, `.inc` generates code at inclusion, and `.g` files create abstractions (no code generation at inclusion).

---

Question & Answer:

---

- [ ] Q. If {APISET} just forwards to {DLL}, why can't I use all the functions exported by {DLL}?

- [x] A. The target windows versions of {APISET} don't have a uniform interface to all the functions in {DLL}. Fine-grained exclusion of targets is outside the scope of umbrella libraries.

- [ ] Q. Something.

- [x] A. Something else.

---

REFERENCES:

---

Windows umbrella libraries

- 

OneCore

- 

WindowsApps

-  (github [SDK][3], [UI][4])

Universal Windows Platform (UWP)

- 

- 

Windows API sets

- 

---

TOOLS:

---

- [WinAPI Search by Dennis A. Babkin](https://dennisbabkin.com/winapisearch/)

- [Api Set Viewer v0.8 (C)2019 by Pavel Yosifovich](https://github.com/zodiacon/ApiSetView)

![GitHub repo size][1] ![GitHub code size in bytes][2] ![visitors][5]

[1]: https://img.shields.io/github/languages/code-size/bitRAKE/fasmg-umbrella?style=for-the-badge

[2]: https://img.shields.io/github/repo-size/bitRAKE/fasmg-umbrella?style=for-the-badge

[3]: https://github.com/microsoft/WindowsAppSDK

[4]: https://github.com/microsoft/microsoft-ui-xaml/

[5]: https://visitor-badge.glitch.me/badge?page_id=bitRAKE/fasmg-umbrella