diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml new file mode 100644 index 0000000..2c46ab1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug-report.yml @@ -0,0 +1,37 @@ +name: Crash Report +labels: ["bug"] +description: 'Please use this template if you encountered rendering issues or glitches (not a crash or freeze)' +body: + - type: input + attributes: + label: yuzu Version + description: 'The version of yuzu you were using when the issue happened' + - type: textarea + attributes: + label: Description + description: 'Please describe what happened?' + placeholder: | + - Which game is this? + - Does this issue also happen in the AppImage version? + - What were you doing when the issue happened? + validations: + required: true + - type: textarea + attributes: + label: System Information + description: 'If possible, install `inxi`, run `inxi -v3` on your system and paste the output here' + render: shell + validations: + required: false + - type: textarea + attributes: + label: Logs + description: 'Please attach the yuzu log file here (how to obtain it: https://yuzu-emu.org/help/reference/log-files/)' + validations: + required: true + - type: textarea + attributes: + label: Remarks + description: 'Do you have something notable to mention? Anything that will give us more context about this issue?' + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..d7f62bd --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: true +contact_links: + - name: Yuzu Community Forum + url: https://community.citra-emu.org/ + about: Please ask basic functionality and usage questions here. diff --git a/.github/ISSUE_TEMPLATE/crash-report.yml b/.github/ISSUE_TEMPLATE/crash-report.yml new file mode 100644 index 0000000..c524277 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/crash-report.yml @@ -0,0 +1,49 @@ +name: Crash Report +labels: ["bug"] +description: 'Please use this template if you experienced a crash or freeze' +body: + - type: input + attributes: + label: yuzu Version + description: 'The version of yuzu you were using when this crash happened' + - type: textarea + attributes: + label: Description + description: 'Please describe what you were doing before and when this crash happened' + validations: + required: true + - type: dropdown + attributes: + label: Reproduction Certainty + description: 'Can you always reproduce this crash? Does this crash happens very often or happens rarely?' + multiple: false + options: + - Always + - Not always, but often + - Sometimes + - Rarely + validations: + required: true + - type: textarea + attributes: + label: System Information + description: 'If possible, install `inxi`, run `inxi -v3` on your system and paste the output here' + render: shell + validations: + required: false + - type: textarea + attributes: + label: Logs and Backtraces + description: 'If possible, please attach the yuzu log file and/or debugger backtrace file here ([how to obtain them](https://github.com/flathub/org.yuzu_emu.yuzu/blob/master/README.md#obtaining-necessary-information-for-bug-reports))' + validations: + required: false + - type: textarea + attributes: + label: Remarks + description: 'Do you have something notable to mention? Anything that will give us more context?' + placeholder: | + - Does this issue also happen in the AppImage version? + - Did you notice any anomalies prior to the crash? + - Does this crash happen in older Flatpak versions? + validations: + required: false diff --git a/README.md b/README.md new file mode 100644 index 0000000..9651d35 --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +# Flatpak for Yuzu Emulator + +Yuzu is an experimental Nintendo Switch emulator. For more information, please [visit our website](https://yuzu-emu.org/). + +To install the Flatpak version of Yuzu Emulator, please visit https://flathub.org/apps/details/org.yuzu_emu.yuzu. + +For issues with basic functionality and usage, please use our [Community Forum](https://community.citra-emu.org/) or join our [Discord channel](https://discord.gg/u77vRWY). + +## Reporting Bugs + +If you encounter any crashes or stability issues, please report them in the issues section of this repository. + +When reporting, make sure to select the appropriate template and follow the instructions in the template. + +### Obtaining Necessary Information for Bug Reports + +Since Yuzu is a complex piece of software, it's very difficult to pinpoint a specific issue. Providing necessary contextual information will help us determine the root cause of the problem you are experiencing. + +Usually, yuzu's own log file will reveal the issue. Please see [How to obtain the log file](https://yuzu-emu.org/help/reference/log-files/) for information on how to collect the log file from your system. + +Sometimes, yuzu's own log file is insufficient to determine the cause, especially if you are reporting a crash or a freeze. +Ideally, we will able to reproduce the issue on our own machines. But there are times when we can't reproduce the crash or freeze on our own machines due to hardware differences. This would require you to provide a debugger trace. +Obtaining a debugger trace is a bit complicated, so please bear with us: + +#### Obtaining a debugger trace after the crash + +1. Install debuggers in Flatpak: `flatpak install org.kde.Sdk//5.15-21.08` +2. Install debug information for yuzu: `flatpak install org.yuzu_emu.yuzu.Debug` +3. Execute this command in your terminal: `flatpak-coredumpctl org.yuzu_emu.yuzu -m yuzu --gdb-arguments "--batch -ex 'thread apply all bt'" > /tmp/yuzu-backtrace.log` +4. Please attach the file `/tmp/yuzu-backtrace.log` file to your report + +#### Obtaining a debugger trace as the crash happens + +1. Install debuggers in Flatpak: `flatpak install org.kde.Sdk//5.15-21.08` +2. Install debug information for yuzu: `flatpak install org.yuzu_emu.yuzu.Debug` +3. Execute this command in your terminal: `flatpak run --devel --command=sh org.yuzu_emu.yuzu` +4. Type `gdb /app/bin/yuzu` in the coming up prompt and wait for the `(gdb)` prompt to show up +5. Type r and hit Enter to launch yuzu under the debugger +6. **Before loading your game**, go to `Emulation` -> `Configure ...` menu. Choose `General` on the left-sidebar, then choose `Debug` tab on the right panel. And then, select the `CPU` tab on the second-level panel, you will see the `Toggle CPU optimizations` options. Please **uncheck** the **Enable fast dispatcher** checkbox (as this would interfere with the debugger) and click the `Confirm` button at the buttom of the dialog. +7. Load the game that caused the crash and repeat the steps you think that may have crashed or freezed yuzu +8. When the crash or freeze happens, switch back to the terminal and type `bt` at the `(gdb)` prompt +9. If `gdb` asks `--Type for more, q to quit, c to continue without paging--`, type kbdc to show all the output +10. Copy and paste all the output to a new text file, and attach this file to your report +11. Type q to kill both the debugger and crashed yuzu +12. (Optional) You might want to undo step (6) to avoid performance penalty after this process