| Both sides previous revisionPrevious revision | |
| getting_started:finish [2025/12/31 07:27] – [Configuring an IDE] 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 ===== |
| |
| 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. |
