| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| getting_started:finish [2025/12/31 07:27] – asie | getting_started:finish [2026/06/03 14:17] (current) – asie |
|---|
| |
| Remember that each target and toolchain may have additional libraries! To discover them, use commands like ''%%wf-pacman -Ss target-wswan%%'' or ''%%wf-pacman -Ss toolchain-gcc-arm-none-eabi%%''. | Remember that each target and toolchain may have additional libraries! To discover them, use commands like ''%%wf-pacman -Ss target-wswan%%'' or ''%%wf-pacman -Ss toolchain-gcc-arm-none-eabi%%''. |
| |
| ===== Configuring environment variables ===== | |
| |
| To make accessing ''%%wf-%%'' tools easy, you may want to alias ''%%wf-env%%'' to allow them to be easily added to PATH when needed: | |
| |
| * For **bash**, add ''%%alias wf-env='source /opt/wonderful/bin/wf-env'%%'' to your ''%%~/.profile%%''. | |
| * For **fish**, add ''%%alias wf-env . /opt/wonderful/bin/wf-env.fish%%'' to your Fish configuration. | |
| * For **zsh**, add ''%%alias wf-env='source /opt/wonderful/bin/wf-env'%%'' to your ''%%~/.zprofile%%''. | |
| |
| Alternatively, you may want to pre-populate the environment variables in your shell on launch: | |
| |
| <WRAP center round important 100%> | |
| This is not recommended for Windows/MSYS2 users. Due to DLL resolution issues, this can cause MSYS2-built programs provided by other developers to not work correctly. Caveat emptor. | |
| </WRAP> | |
| |
| * For **bash**, add ''%%source /opt/wonderful/bin/wf-env%%'' to your ''%%~/.profile%%''. | |
| * For **fish**, add ''%%. /opt/wonderful/bin/wf-env.fish%%'' to your Fish configuration. | |
| * For **zsh**, add ''%%source /opt/wonderful/bin/wf-env%%'' to your ''%%~/.zprofile%%''. | |
| |
| If you want to access toolchain components (like ''ia16-elf-gcc'' or ''arm-none-eabi-objdump'') directly, you may wish to add the ''%%-a%%'' argument. | |
| |
| ===== Configuring an IDE ===== | ===== Configuring an IDE ===== |
| - Press the "Install" button and follow any further instructions displayed by the IDE. | - Press the "Install" button and follow any further instructions displayed by the IDE. |
| |
| Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the following IDEs have been tested and should at least partially work: | Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the following IDEs are occasionally tested and should at least partially work: |
| |
| * Visual Studio Code, using Microsoft's own C extension with IntelliSense, | * Visual Studio Code, using Microsoft's own C extension with IntelliSense, |
| |
| Detailed (to the best of the toolchain's ability) information about each target and feature is available throughout [[:start|the wiki]]. You may also wish to consult [[:community|other community members]]. Have fun and remember not to take this hobby too seriously! | Detailed (to the best of the toolchain's ability) information about each target and feature is available throughout [[:start|the wiki]]. You may also wish to consult [[:community|other community members]]. Have fun and remember not to take this hobby too seriously! |
| | |
| | ===== Configuring the environment (for Manual guide users) ===== |
| | |
| | If you haven't used any of the automatic installers, the environment variables required to use the Wonderful toolchain won't be configured automatically. |
| | |
| | To make accessing ''%%wf-%%'' tools easy, you may want to alias ''%%wf-env%%'' to allow them to be easily added to PATH when needed: |
| | |
| | * For **bash**, add ''%%alias wf-env='source /opt/wonderful/bin/wf-env'%%'' to your ''%%~/.profile%%''. |
| | * For **fish**, add ''%%alias wf-env . /opt/wonderful/bin/wf-env.fish%%'' to your Fish configuration. |
| | * For **zsh**, add ''%%alias wf-env='source /opt/wonderful/bin/wf-env'%%'' to your ''%%~/.zprofile%%''. |
| | |
| | Alternatively, you may want to pre-populate the environment variables in your shell on launch: |
| | |
| | <WRAP center round important 100%> |
| | This is not recommended for Windows/MSYS2 users. Due to DLL resolution issues, this can cause MSYS2-built programs provided by other developers to not work correctly. Caveat emptor. |
| | </WRAP> |
| | |
| | * For **bash**, add ''%%source /opt/wonderful/bin/wf-env%%'' to your ''%%~/.profile%%''. |
| | * For **fish**, add ''%%. /opt/wonderful/bin/wf-env.fish%%'' to your Fish configuration. |
| | * For **zsh**, add ''%%source /opt/wonderful/bin/wf-env%%'' to your ''%%~/.zprofile%%''. |
| | |
| | If you want to access toolchain components (like ''ia16-elf-gcc'' or ''arm-none-eabi-objdump'') directly, you may wish to add the ''%%-a%%'' argument. |